PvFreeDbNamesData()

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

Previous

DTI Programmer's Guide (v10)

Next

PvFreeDbNamesData()

Chapter contents

Free the resource allocated for database names on a connected server. This function needs to be called after preceding calls to PvGetDbNamesData.

Header file: CATALOG.HRequires: W3DBAV75.DLL or higher version

Syntax

BTI_SINT PvFreeDbNamesData( 
	BTI_LONG           hConnection);

Arguments


In	hConnection	Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function.

Return Values


P_OK	The operation was successful.
P_E_INVALID_HANDLE	Invalid connection handle.
P_E_DATA_UNAVAILABLE	Data related to database names not available.
P_E_FAIL	Failed for other reasons.

Remarks

The following preconditions must be met:

Connection established by PvConnectServer() or if you are performing the operation on a local machine, P_LOCAL_DB_CONNECTION may be used as the connection handle.

Database names data retrieved by calling PvGetDbNamesData() .

See Also

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

The following published functions can also be used to get database names. See SQL Engine Reference for more details:

SQLGetCountDatabaseNames()

SQLGetCountRemoteDatabaseNames()

SQLGetDatabaseNames()

SQLGetRemoteDatabaseNames()

SQLUnloadDBNames()

Chapter contents
Book contents

Prev topic: PvDropUser()
Next topic: PvFreeMkdeClientsData()