DbiFormFullName
|
<< Click to Display Table of Contents >> DbiFormFullName |
![]() ![]()
|
C syntax
DBIResult DBIFN DbiFormFullName (hDb, pszTableName, pszDriverType, pszFullName);
Delphi syntax
function DbiFormFullName (hDb: hDBIDb; pszTableName: PChar; pszDriverType: PChar; pszFullName: PChar): DBIResult stdcall;
Description
DbiFormFullName returns the fully qualified table name.
Parameters
hDb Type: hDBIDb (Input)
Specifies the database handle.
pszTableName Type: pCHAR (Input)
Pointer to the table name.
pszDriverType Type: pCHAR (Input)
Pointer to the driver type.
pszFullName Type: pCHAR (Output)
Pointer to the client buffer that receives the fully qualified table name. pszFullName should be allocated for DBIMAXTBLNAMELEN.
Usage
If the given table name contains a beginning drive letter followed by a colon, this function simply returns the same table name that was passed in without changing it. Otherwise, this function qualifies the table name using the directory associated with the supplied database handle. You can use DbiSetDirectory to change this directory. The table name need not be an existing file.
DbiResult |
Meaning |
DBIERR_NONE |
The table name has been successfully returned. |
DBIERR_INVALIDFILENAME |
The specified table name is invalid. This might occur if the combined length of the directory and table name are greater than DBIMAXTBLNAMELEN). Output pszFullname is left unchanged. |
See also