|
<< Click to Display Table of Contents >> DbiOpenSecurityList |
![]() ![]()
|
C syntax
DBIResult DBIFN DbiOpenSecurityList (hDb, pszTableName, [pszDriverType], phSecCur);
Delphi syntax
function DbiOpenSecurityList (hDb: hDBIDb; pszTableName: PChar; pszDriverType: PChar; var hSecCur: hDBICur): DBIResult stdcall;
Description
DbiOpenSecurityList creates a table listing record-level security information about a specified table.
Parameters
hDb Type: hDBIDb (Input)
Specifies the database handle.
pszTableName Type: pCHAR (Input)
Pointer to the table name. If pszTableName is a fully qualified name of a table, the pszDriverType parameter need not be specified. If the path is not included, the path name is taken from the current directory of the database associated with hDb.
pszDriverType Type: pCHAR (Input)
Pointer to the driver type. Required only if pszTableName did not specify an extension. Currently, the only valid driver type is szPARADOX.
phSecCur Type: phDBICur (Output)
Pointer to the cursor handle.
Usage
Table- and field-level security is applied with the functions DbiDoRestructure and DbiCreateTable. Currently, supported only with Paradox tables.
Completion state
Each of the security information records can be retrieved via DbiGetNextRecord. DbiGetCursorProps can be used to allocate the proper record size. After the record is retrieved, it can be cast with the SECDesc type definition, and used like an SECDesc C language structure.
DbiResult |
Meaning |
DBIERR_NONE |
The cursor was returned successfully. |
DBIERR_INVALIDHNDL |
The specified database handle is invalid or NULL, or phSecCur is NULL. |
DBIERR_INVALIDPARAM |
The specified table name or the pointer to the table name is NULL. |
DBIERR_NOSUCHTABLE |
The specified table name does not exist. |
DBIERR_UNKNOWNTBLTYPE |
The specified table type is invalid. |
See also