3.1.5.10 R_InetInfoGetServerCapabilities (Opnum 9)

  • Article

The R_InetInfoGetServerCapabilities method is called by the client. In response, the server returns information on the features of the Internet protocol servers and the host operating system.

 DWORD R_InetInfoGetServerCapabilities(
   [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer,
   [in] DWORD dwReserved,
   [out] LPINET_INFO_CAPABILITIES_STRUCT* ppCap
 );

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.

dwReserved: This value MUST be ignored by the server.

ppCap: The pointer to an INET_INFO_CAPABILITIES_STRUCT structure that indicates the capabilities of the Internet protocol servers on the host system.

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.

ERROR_SUCCESS (0x00000000)

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 MUST initialize ppCap with those features supported by the current version of the Internet protocol servers if the return code indicates success.