Library > Products > Pervasive PSQL SDK > Pervasive PSQL SDK v10 > DTI Programmer's Guide > Distributed Tuning Interface Reference > PvGetDbFlags()

PreviousDTI Programmer's Guide (v10) Next

PvGetDbFlags()

Chapter contents

Retrieves the database flags associated with a named database.

Header file: CATALOG.H
Requires: W3DBAV75.DLL or higher version

Syntax 

BTI_SINT PvGetDbFlags( 
	BTI_LONG           hConnection, 
	BTI_CHAR_PTR       dbName, 
	BTI_ULONG_PTR      pDbFlags);

Arguments

In
hConnection
Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function.
In
dbName
Name of the database. A list of all database names for a particular server is obtained with the PvGetDbNamesData() function. A single database name from the resulting list can be obtained with the PvGetDbName() function.
Out
pDbFlags
Database flags, which can be a combination of the P_DBFLAG_ constants.
P_DBFLAG_RI (integrity constraints, including referential integrity and triggers)
P_DBFLAG_BOUND (DDF files stamped with the database name so only that database can use them)
P_DBFLAG_DBSEC_AUTHENTICATION (Mixed security policy. See Btrieve Security Policy .)
P_DBFLAG_DBSEC_AUTHORIZATION (Database security policy. See Btrieve Security Policy .)
P_DBFLAG_LONGMETADATA (see Metadata Version )

Return Values

P_OK
The operation was successful.
P_E_INVALID_HANDLE
Invalid connection handle.
P_E_NULL_PTR
Call with NULL pointer
P_E_NOT_EXIST
Named database does not exist.
P_E_FAIL
Failed for other reasons.

Remarks

The following precondition must be met:

Btrieve Security Policy

The following table indicates how to interpret the security model of an existing database.

This Flag Combination
Represents this Security Model
No flags
Classic
P_DBFLAG_DBSEC_AUTHENTICATION
Mixed
P_DBFLAG_DBSEC_AUTHENTICATION + P_DBFLAG_DBSEC_AUTHORIZATION
Database

See Also

PvStart()
PvConnectServer()
PvCreateDatabase()
PvModifyDatabase()
PvGetDbNamesData()
PvGetDbName()
PvDisconnect()
PvStop()

Chapter contents
Book contents

Prev topic: PvGetDbDictionaryPath()
Next topic: PvGetDbName()