RpcMgmtInqStats 函数 (rpcdce.h)

  • 项目

RpcMgmtInqStats 函数返回 RPC 运行时统计信息。

语法

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

参数

Binding

若要接收有关远程应用程序的统计信息，请指定该应用程序的服务器绑定句柄。 若要接收有关自己的 (本地) 应用程序的统计信息，请指定 NULL 值。

Statistics

返回指向由 Binding 参数指定的服务器统计信息的指针的指针。 每个统计信息都是 一个无符号长 值。

返回值

值 含义
RPC_S_OK
 调用成功。
RPC_S_INVALID_BINDING
 绑定句柄无效。
RPC_S_WRONG_KIND_OF_BINDING
 这是操作的错误绑定类型。
 
注意 有关有效错误代码的列表，请参阅 RPC 返回值。
 

注解

应用程序调用 RpcMgmtInqStats 函数，以从 RPC 运行时库获取有关指定服务器的统计信息。

返回的统计信息向量中的每个数组元素都包含 一个无符号长 值。 下表描述了由指定常量编制索引的统计信息。

统计信息 说明
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)
Library Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

RpcEpResolveBinding

RpcMgmtStatsVectorFree