DbiOpenSecurityList

<< Click to Display Table of Contents >>

Navigation:  »No topics above this level«

DbiOpenSecurityList

Return to chapter overview

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

DbiCreateTable, DbiDoRestructure