AdsFindNextTable62

Advantage Client Engine

 

Finds the next table matching the file mask provided in a previous call to AdsFindFirstTable62.

Syntax

UNSIGNED32 ENTRYPOINT AdsFindNextTable62 ( ADSHANDLE hConnect,

SIGNED32 lHandle,

UNSIGNED8 *pucDDName,

UNSIGNED16 *pusDDLen,

UNSIGNED8 *pucFileName,

UNSIGNED16 *pusFileLen );

Parameters

hConnect (I)

Handle of connection.

lHandle (I)

Find handle from a call to AdsFindFirstTable.

pucDDName (O)

If the table found is in a linked dictionary, the name of the link is returned in this buffer.

pusDDLen (I/O)

Length of pucDDName on input, length of returned data on output.

pucFileName (O)

Next matching tablename is returned in this buffer.

pusFileLen (I/O)

Length of pucFileName on input, length of returned data on output.

Special Return Codes

AE_NO_FILE_FOUND

No tables were found.

Remarks

Use AdsFindNextTable62 to continue a search started with the AdsFindFirstTable62 API.

Call AdsFindClose when your work with the find handle (lHandle) is complete.

Example

usLen = ADS_MAX_TABLE_NAME;

usAliasLen = ADS_MAX_OBJECT_NAME;

ulRetVal = AdsFindFirstTable62( hConn, aucTableMask,

aucDictionaryAlias, &usAliasLen,

aucTable, &usLen, &hFindHandle );

if ( (ulRetVal != AE_NO_FILE_FOUND) && (ulRetVal != AE_SUCCESS) )

return ulRetVal;

 

while ( ulRetVal != AE_NO_FILE_FOUND )

{

// Do your work with aucDictionaryAlias and aucTable here...

 

// now get the next table

usLen = ADS_MAX_TABLE_NAME;

usAliasLen = ADS_MAX_OBJECT_NAME;

ulRetVal = AdsFindNextTable62( hConn, hFindHandle,

aucDictionaryAlias, &usAliasLen, aucTable, &usLen );

if ( (ulRetVal != AE_NO_FILE_FOUND) && (ulRetVal != AE_SUCCESS) )

return ulRetVal;

}

 

AdsFindClose( hConn, hFindHandle );

See Also

AdsFindFirstTable

AdsFindNextTable

AdsFindClose

AdsFindFirstTable62