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

另請參閱

RpcEpResolveBinding

RpcMgmtStatsVectorFree