Distributed Tuning Interface Guide (v11)

PvGetFileHandlesData() (DTI 関数)

開いているファイルに関連するファイル ハンドルの情報をすべて取得します。

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

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

構文

BTI_SINT PvGetFileHandlesData( 
	BTI_LONG           hConnection, 
	BTI_CHAR_PTR       fileName, 
	BTI_ULONG_PTR      pCount); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
fileName
照会するファイルの絶対パス名。
Out
pCount
開いているファイルのハンドル数を受け取る、符号なし Long 型のアドレス。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_DATA_UNAVAILABLE
アクティブなクライアントに関連するデータがありません。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_FILE_NOT_OPEN
指定されたファイルは現在開いていません。
P_E_FAIL
名前付きサーバーからの切断に失敗しました。

備考

情報は、ファイル ハンドルに関連する以降の呼び出しのために、DTI によってキャッシュされます。この関数は、開いているファイルに対し、ファイル ハンドル情報を取得するほかの関数よりも先に呼び出される必要があります。PvFreeOpenFilesData() (DTI 関数)を呼び出すと、ファイル ハンドルのキャッシュ情報が解放されます。

以下の前提条件を満たす必要があります。

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetOpenFilesData() (DTI 関数)
PvFreeOpenFilesData() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvGetError() (DTI 関数)

PvGetFileHandleInfo() (DTI 関数)