PvOpenDictionary()
既存の辞書を開きます。辞書の絶対パスまたはデータ ソース名を指定すると、以降の任意の関数への呼び出しで使用する辞書ハンドルが返されます。
メモ: この関数は PSQL 9 以降のバージョンでは使用が推奨されません。アプリケーションでこの関数を置き換えるには、
PvOpenDatabase()を参照してください。
ヘッダー ファイル:ddf.h(
ヘッダー ファイルも参照)
関数が最初に利用可能になるライブラリ:w3dbav75.dll(Windows)、libpsqldti.so(Linux)、libpsqldti.dylib(OS X)(
リンク ライブラリも参照)
構文
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()を使用します。
関連項目