RpcMgmtInqStats 関数 (rpcdce.h)
RpcMgmtInqStats 関数は RPC ランタイム統計を返します。
構文
RPC_STATUS RpcMgmtInqStats(
RPC_BINDING_HANDLE Binding,
RPC_STATS_VECTOR **Statistics
);
パラメーター
Binding
リモート アプリケーションに関する統計情報を受信するには、そのアプリケーションのサーバー バインド ハンドルを指定します。 独自の (ローカル) アプリケーションに関する統計を受け取る場合は、 値 NULL を指定します。
Statistics
Binding パラメーターで指定されたサーバーに関する統計情報へのポインターへのポインターを返します。 各統計は 符号なし long 値です。
戻り値
| 値 | 意味 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効でした。 |
|
これは、操作の間違った種類のバインドでした。 |
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
注釈
アプリケーションは RpcMgmtInqStats 関数を呼び出して、RPC ランタイム ライブラリから指定されたサーバーに関する統計情報を取得します。
返される統計ベクトル内の各配列要素には 、符号なし long 値が 含まれています。 次の表は、指定した定数によってインデックスが作成された統計を示しています。
| 統計 | 説明 |
|---|---|
| RPC_C_STATS_CALLS_IN | バインド ハンドルによって指定された RPC サーバーによって受信されたリモート プロシージャ 呼び出しの数。 |
| RPC_C_STATS_CALLS_OUT | バインド ハンドルによって指定された RPC サーバーによって開始されるリモート プロシージャ 呼び出しの数。 |
| RPC_C_STATS_PKTS_IN | バインド ハンドルによって指定された RPC サーバーによって受信されたネットワーク パケットの数。 |
| RPC_C_STATS_PKTS_OUT | バインド ハンドルによって指定された RPC サーバーによって送信されるネットワーク パケットの数。 |
RPC ランタイム ライブラリは、統計ベクトルにメモリを割り当てます。 アプリケーションは、 RpcMgmtStatsVectorFree 関数を呼び出して、統計ベクトルによって使用されるメモリを解放する役割を担います。
この関数を成功させるには、サーバーがリモート プロシージャ 呼び出しをリッスンしている必要があります。 サーバーがリッスンしていない場合、関数は失敗します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |