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 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcdce.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |