AdsGetTableFilename

Advantage Client Engine

Returns the table name as the base name, the base name with extension, or the full path name (UNC format)

Syntax

UNSIGNED32

AdsGetTableFilename (ADSHANDLE hTable,

UNSIGNED16 usOption,

UNSIGNED8 *pucName,

UNSIGNED16 *pusLen);

Parameters

hTable (I)

Handle of table or cursor.

usOption (I)

Specifies the portion of the filename desired. Valid options are ADS_BASENAME (retrieve the name of the file without the extension), ADS_BASENAMEANDEXT (retrieve the name of the file with the extension), ADS_FULLPATHNAME (retrieve the fully qualified UNC filename).

pucName (O)

Name of table is returned in this buffer.

pusLen (I/O)

Length of given buffer on input, length of returned data on output.

Remarks

If the ADS_FULLPATHNAME is given as the option, then the fully qualified UNC path name is returned regardless of how the file was opened. For example, even if the file was opened with a drive letter style path (e.g. f:\data\file.dbf), a UNC filename will be returned by this routine (e.g., \\server\volume\data\file.dbf).

Example

Click Here

See Also

AdsCreateTable

AdsOpenTable

AdsGetTableHandle

AdsGetIndexFilename