<< Click to Display Table of Contents >> Navigation:  Apollo API Listing > sx_RYOFilterCopy

VB Declaration

Declare Function sx_RYOFilterCopy Lib "Apollo9.dll" () As Integer

C Declaration

SHORT FAR PASCAL sx_RYOFilterCopy (VOID);

Description

Copies the existing filter bitmap to the linked list of RYO Filter bitmaps. The existing filter bitmap may be the result of an sx_Query operation.

Return Value

Returns an integer handle that will subsequently identify this bitmap in further RYO Filter operations. If the result is zero, the operation failed.

VB Example

' Create bitmap containing next five records

hBitMap = sx_RYOFilterCreate

For i = 1 To 5

sx_RYOFilterSetBit( hBitMap, sx_RecNo, True )

sx_Skip 1

Next i

 

' Save this bitmap to linked list for later use

iSaved = sx_RYOFilterCopy

C Example

// Create bitmap containing next five records

SHORT i, hBitMap, iSaved;

 

hBitMap = sx_RYOFilterCreate ();

for (i = 0; i < 5; i++)

{  

sx_RYOFilterSetBit( hBitMap, sx_RecNo(), TRUE );

sx_Skip(1);

}

 

// Save this bitmap to linked list for later use

iSaved = sx_RYOFilterCopy();

See Also

sx_RYOFilterActivate, sx_RYOFilterCreate, sx_RYOFilterDestroy, sx_RYOFilterRestore, sx_RYOFilterSave, sx_RYOFilterSetBit