RpcMgmtInqStats 函数 (rpcdce.h)
RpcMgmtInqStats 函数返回 RPC 运行时统计信息。
语法
RPC_STATUS RpcMgmtInqStats(
RPC_BINDING_HANDLE Binding,
RPC_STATS_VECTOR **Statistics
);
参数
Binding
若要接收有关远程应用程序的统计信息,请指定该应用程序的服务器绑定句柄。 若要接收有关自己的 (本地) 应用程序的统计信息,请指定 NULL 值。
Statistics
返回指向由 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 |