RpcMgmtInqStats

The RpcMgmtInqStats function returns RPC run-time statistics.

This function is supported by both 32-bit platforms — Windows NT and Windows 95.

#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtInqStats( 
  RPC_BINDING_HANDLE  Binding,   
  RPC_STATS_VECTOR * *  Statistics  
);

Parameters

Binding
To receive statistics about a remote application, specify a server binding handle for that application. To receive statistics about your own (local) application, specify a value of NULL.
Statistics
Returns a pointer to a pointer to the statistics about the server specified by the Binding argument. Each statistic is an unsigned long value.

Remarks

An application calls the RpcMgmtInqStats routine to obtain statistics about the specified server from the RPC run-time library.

Each array element in the returned statistics vector contains an unsigned long value. The following list describes the statistics indexed by the specified constant:

Statistic Description
RPC_C_STATS_CALLS_IN The number of remote procedure calls received by the server
RPC_C_STATS_CALLS_OUT The number of remote procedure calls initiated by the server
RPC_C_STATS_PKTS_IN The number of network packets received by the server
RPC_C_STATS_PKTS_OUT The number of network packets sent by the server

The RPC run-time library allocates memory for the statistics vector. The application is responsible for calling the RpcMgmtStatsVectorFree routine to release the memory used by the statistics vector.

Return Values

Value Meaning
RPC_S_OK Success
RPC_S_INVALID_BINDING Invalid binding handle
RPC_S_WRONG_KIND_OF_BINDING Wrong kind of binding for operation

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcEpResolveBinding, RpcMgmtStatsVectorFree