Distributed Tuning Interface Guide (v11)

PvGetFileHandleInfo() (DTI 関数)

開いているファイルに関連付けられたファイル ハンドルの情報を照会します。

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

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

構文

BTI_SINT PvGetFileHandleInfo( 
	BTI_LONG           hConnection, 
	BTI_CHAR_PTR       fileName, 
	BTI_ULONG          sequence, 
	PVFILEHDLINFO*     pFileHdlInfo); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
fileName
照会するファイルの絶対パス名。
In
sequence
ファイル ハンドルのシーケンス番号(0 基準)。PvGetFileHandlesData() (DTI 関数)によって取得されるファイル ハンドル数を上限とした、有効な範囲内の番号でなければなりません。
Out
pFileHdlInfo
ファイル ハンドルの情報を受け取る PVFILEHDLINFO 構造体のアドレス。

戻り値

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

備考

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

関連項目

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


PvGetFileHandlesData() (DTI 関数)

PvGetFileInfo() (DTI 関数)