3.1.5.6 R_InetInfoSetGlobalAdminInformation (Opnum 5)

The R_InetInfoSetGlobalAdminInformation assigns global settings for all Internet protocol servers present on the host system.

 DWORD R_InetInfoSetGlobalAdminInformation(
   [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer,
   [in] DWORD dwServerMask,
   [in, ref] INET_INFO_GLOBAL_CONFIG_INFO* pConfig
 );

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.

dwServerMask: This value MUST be ignored by the server.

pConfig: The pointer to an INET_INFO_GLOBAL_CONFIG_INFO structure that contains global administrative information.

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 most common error codes are listed in the following table.

Return value/code

Description

0x00000005

ERROR_ACCESS_DENIED

Access is denied.

0x00000032

ERROR_NOT_SUPPORTED

The request is not supported.

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 set the configurable properties in pConfig into the configuration store for the Internet protocol servers if the return code indicates success.