Distributed Tuning Interface Guide (v11)

PvGetMkdeClientHandlesData() (DTI 関数)

アクティブな MKDE クライアントに関連する MKDE クライアント ハンドルの数を取得します。

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

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

構文

BTI_SINT PvGetMkdeClientHandlesData( 
	BTI_LONG           hConnection, 
	PVCLIENTID*        pClientId, 
	BTI_ULONG_PTR      pCount); 

引数

In
hConnection
サーバーを識別する接続ハンドル。接続ハンドルは PvConnectServer() (DTI 関数)関数によって取得されます。
In
pClientId
MKDE クライアントを識別する PVCLIENTID 構造体のアドレス。
Out
pCount
MKDE クライアントのハンドル数を受け取る、符号なし Long 型のアドレス。

戻り値

P_OK
操作は成功しました。
P_E_INVALID_HANDLE
接続ハンドルが無効です。
P_E_DATA_UNAVAILABLE
MKDE クライアントに関連するデータがありません。
P_E_NULL_PTR
ヌル ポインターによる呼び出しです。
P_E_FAIL
その他の理由により失敗しました。

備考

この関数を呼び出すと、MKDE クライアント ハンドルに関するすべての情報が、それ以降の MKDE クライアント ハンドル関連の関数呼び出しのために、DTI によってキャッシュされます。MKDE クライアントに関するその他の情報については、PvGetMkdeClientsData() (DTI 関数)を参照してください。

この関数は、MKDE クライアント ハンドルの情報を返すほかの関数よりも先に呼び出される必要があります。

PvFreeMkdeClientsData() (DTI 関数)を呼び出すと、MKDE クライアント ハンドル用にキャッシュされた情報が MKDE クライアントに関する情報と一緒に解放されます。

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

関連項目

PvStart() (DTI 関数)
PvConnectServer() (DTI 関数)
PvGetMkdeClientsData() (DTI 関数)
PvFreeMkdeClientsData() (DTI 関数)
PvDisconnect() (DTI 関数)
PvStop() (DTI 関数)


PvGetMkdeClientInfo() (DTI 関数)

PvGetMkdeClientHandleInfo() (DTI 関数)