PreviousDTI Programmer's Guide (v10) Next

PvDeleteDSN()

Chapter contents

Deletes a data source name.

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

Syntax

PRESULT PvDeleteDSN( 
	BTI_LONG       hConnection, 
	BTI_CHAR_PTR   pdsnName); 

Arguments

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

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_DSN_DOES_NOT_EXIST
The specified DSN name does not exist.
P_E_ACCESS_RIGHT
Insufficient access right for the operation.
P_E_FAIL
Failed to retrieve data path.

Remarks

The following preconditions must be met:

See Also

PvStart()
PvConnectServer()
PvListDSNs()
PvModifyDSN()
PvGetDSN()
PvGetDSNEx()
PvCreateDSN()
PvCountDSNs()
PvStop()


Chapter contents
Book contents

Prev topic: PvCreateUser()
Next topic: PvDeleteLicense()