3.1.5.7 R_InetInfoQueryStatistics (Opnum 6)
The R_InetInfoQueryStatistics method is called by the client. In response, the server retrieves statistical data for the specified Internet protocol server.
-
DWORD R_InetInfoQueryStatistics( [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer, [in] DWORD Level, [in] DWORD dwServerMask, [out, switch_is(Level)] LPINET_INFO_STATISTICS_INFO StatsInfo );
pszServer: The custom binding handle for the target system, as specified in section 2.1.1. The value MUST NOT be used by the server implementation.
Level: The level of detail to be retrieved. This member MUST be set to 0. If another value is sent by the client, the server MUST return ERROR_INVALID_LEVEL (0x0000007C).
dwServerMask: The identifier for the target Internet protocol server, as specified in section 2.2.2. A value of 0 indicates that aggregate statistical data is to be returned for all protocol servers.
StatsInfo: The pointer to an INET_INFO_STATISTICS_INFO union that contains the data to be returned.
Return Values: The method returns 0 (ERROR_SUCCESS) to indicate success; otherwise, it returns a nonzero error code, as specified in [MS-ERREF] section 2.2 or [MS-ERREF] section 2.3.1. The following table describes possible error code values.
-
Return value/code
Description
0x0000007C
ERROR_INVALID_LEVEL
The system call level is not correct.
Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol, as specified in [MS-RPCE].
In response to this request from the client, the server MAY return the statistical data in StatsInfo if the return code indicates success.<11>