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