In | hConnection | Connection handle that identifies the server. Connection handles are obtained with the PvConnectServer() function. |
In | dsnName | Name of the datasource. A list of DSNs can be obtained with the PvListDSNs() function. |
In/Out | pdsnDescSize | Address of an unsigned long containing size of the buffer for DSN description. Receives actual size of DSN description. |
Out | dsnDesc | Contains the description of DSN if successful. |
In/Out | pdsnDBQSize | Address of an unsigned long containing size of the buffer for name of database. Receives actual size of database name. |
Out | dsnDBQ | Contains the name of the database if successful. |
Out | pOpenMode | Open mode for the DSN, which is one of the following: •NORMAL_MODE •ACCELERATED_MODE •READONLY_MODE •EXCLUSIVE_MODE See also DSN Open Mode in ODBC Guide. |
Out | translate | Encoding option for data, which can be one of the following: •DSNFLAG_DEFAULT •DSNFLAG_OEMANSI •DSNFLAG_AUTO See also DSN Open Mode in ODBC Guide. Note that DSNFLAG_DEFAULT corresponds to the “None” encoding option in ODBC Administrator. |
P_OK | The operation was successful. |
P_E_INVALID_HANDLE | Invalid connection handle. |
P_E_NULL_PTR | Call with NULL pointer |
P_E_BUFFER_TOO_SMALL | The buffer is too small for the string. In this case, the required buffer size is returned in pdsnDescSize or pdsnDBQSize. |
P_E_ACCESS_RIGHT | Insufficient access right for the operation. |
P_E_DSN_DOES_NOT_EXIST | The specified DSN does not exist. |
P_E_INVALID_OPEN_MODE | Invalid open mode. |
P_E_INVALID_TRANSLATE_OPTION | The specified encoding translation option is invalid. |
P_E_FAIL | Failed to retrieve data path. |