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 |
See Also