|
データ ソース名(DSN)に関する情報を取得します。
ヘッダー ファイル:catalog.h(「ヘッダー ファイル」も参照)
関数が最初に利用可能になるライブラリ:w3dbav75.dll(Windows)、libpsqldti.so(Linux)(「リンク ライブラリ」も参照)
この関数を Pervasive PSQL v11 以降のバージョンで使用することは推奨されません。クライアント DSN を使った作業には、ODBC API を使用してください。
BTI_API PvGetDSN( BTI_LONG hConnection, BTI_CHAR_PTR dsnName, BTI_ULONG_PTR pdsnDescSize, BTI_CHAR_PTR dsnDesc, BTI_ULONG_PTR pdsnDBQSize, BTI_CHAR_PTR dsnDBQ);
In
|
hConnection
|
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
|
In
|
dsnName
|
データ ソース名。DSN の一覧は、PvListDSNs() (DTI 関数)関数を使って取得できます。
|
In/Out
|
pdsnDescSize
|
DSN の説明のバッファーのサイズを格納する、符号なし Long 型のアドレス。DSN の説明の実際のサイズを受け取ります。
|
Out
|
dsnDesc
|
成功した場合は、DSN の説明が格納されます。
|
In/Out
|
pdsnDBQSize
|
データベース名用のバッファーのサイズを格納する、符号なし Long 型のアドレス。データベース名の実際のサイズを受け取ります。
|
Out
|
dsnDBQ
|
成功した場合は、データベースの名前が格納されます。
|
以下の前提条件を満たす必要があります。
ユーザーにログイン要求をしないで DSN に関する情報を取得するには、PvConnectServer() (DTI 関数)を使ってサーバー接続を確立するとき、userName と password に空文字列を渡します。
メモ
userName と password に空文字列を渡して確立した接続は、セキュリティで保護されていない接続であるため、DTI のこれ以外のほとんどの操作を実行するのに十分なアクセス権を持たない接続となります。
PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetDSNEx() (DTI 関数)
PvListDSNs() (DTI 関数)
PvCountDSNs() (DTI 関数)
PvCreateDSN() (DTI 関数)
PvModifyDSN() (DTI 関数)
PvDeleteDSN() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)
|