Distributed Tuning Interface Guide (v11)

PvOpenDictionary() (DTI 関数)

既存の辞書を開きます。辞書の絶対パスまたはデータ ソース名を指定すると、以降の任意の関数への呼び出しで使用する辞書ハンドルが返されます。


メモ

この関数は Pervasive PSQL 9 以降のバージョンでは使用が推奨されません。アプリケーションでこの関数を置き換えるには、PvOpenDatabase() (DTI 関数)を参照してください。


ヘッダー ファイル:ddf.h(ヘッダー ファイルも参照)

関数が最初に利用可能になるライブラリ:w3dbav75.dll(Windows)、libpsqldti.so(Linux)(リンク ライブラリも参照)

構文

PRESULT PvOpenDictionary( 
	LPTSTR          path, 
	WORD*           dictHandle, 
	LPSTR           user, 
	LPSTR           password); 

引数

In
path
辞書ファイルへの完全修飾パス。
Out
dictHandle
以降の呼び出しで使用するハンドル。
In
user
辞書を開くために必要なユーザー名。この引数はヌルに設定できます。
In
password
辞書ファイルを開くためにユーザー名と共に使用します。ヌルでもかまいません。

戻り値

PCM_Success
操作は成功しました。
PCM_errFailed
操作は成功しませんでした。
PCM_errMemoryAllocation
メモリの割り当て中にエラーが発生しました。
PCM_errDictionaryPathNotFound
指定された辞書のパスが無効です。
PCM_errDictionaryAlreadyOpen
指定された辞書ファイルは現在開いています。
PCM_SessionSecurityError
ユーザー名かパスワードのどちらかが無効です。

備考

この関数は、DTI を使って DDF にアクセスする場合は、まず最初に呼び出される必要があります。

複数の辞書を同時に開くことができます。

リソースを解放するには、PvCloseDictionary() (DTI 関数)を使用します。

関連項目

PvStart() (DTI 関数)
PvCreateDictionary() (DTI 関数)
PvCreateDatabase() (DTI 関数)
PvCloseDictionary() (DTI 関数)
PvStop() (DTI 関数)


PvOpenDatabase() (DTI 関数)

PvRemoveUserFromGroup() (DTI 関数)