## Printer Device Driver

[prev][next][parent][TOC]

### GplStringSorterGetNextString

Description

This function is used to retrieve the next string matching the retrieve criteria passed in on the last call to GplStringSorterGetFirstString(). The criteria is based on the ulOption and rectlBand parameters from that function). This function can be called multiple times until an ERROR_NO_ MORE_ITEMS return code is detected. Each successful call (NO_ERROR) returns another string from the string sorter instance meeting the criteria until no more strings meet the criteria.

Format

    APIRET APIENTRY GplStringSorterGetNextString( HSORTER  hStrSort

                                                  PSZ      *ppszStr,

                                                  PRECTL   prectlStr

                                                  PPVOID   ppUserDef );

Parameters

hStrSort (HSORTER) Handle of the string-sorter instance to be used for the retrieve operation.

*ppszStr (PSZ) - output Pointer to the location that the text string will be retrieved to.

prectlStr (PRECTL) - output Bounding rectangle of the string being retrieved.

ppUserDef (PPVOID) - output Pointer to user-defined data stored with string during the insert operation.

Returns

Success NO_ERROR
Failure ERROR_xxx