RpcMgmtInqStats 関数 (rpcdce.h)

  • [アーティクル]

RpcMgmtInqStats 関数は RPC ランタイム統計を返します。

構文

RPC_STATUS RpcMgmtInqStats(
  RPC_BINDING_HANDLE Binding,
  RPC_STATS_VECTOR   **Statistics
);

パラメーター

Binding

リモート アプリケーションに関する統計情報を受信するには、そのアプリケーションのサーバー バインド ハンドルを指定します。 独自の (ローカル) アプリケーションに関する統計を受け取る場合は、 値 NULL を指定します。

Statistics

Binding パラメーターで指定されたサーバーに関する統計情報へのポインターへのポインターを返します。 各統計は 符号なし long 値です。

戻り値

値 意味
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_BINDING
 バインド ハンドルが無効でした。
RPC_S_WRONG_KIND_OF_BINDING
 これは、操作の間違った種類のバインドでした。
 
メモ 有効なエラー コードの一覧については、「 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

こちらもご覧ください

RpcEpResolveBinding

RpcMgmtStatsVectorFree