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>