|
アクティブな 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 関数)
|