3.1.5.4 R_InetInfoSetAdminInformation (Opnum 3)

  • Article

The R_InetInfoSetAdminInformation method is called by the client. In response, the server sets configurable properties for the specified Internet protocol server.

 DWORD R_InetInfoSetAdminInformation(
   [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer,
   [in] DWORD dwServerMask,
   [in, ref] INET_INFO_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: The identifier for the target Internet protocol server, as specified in section 2.2.2.

pConfig: The pointer to an INET_INFO_CONFIG_INFO structure containing the property configuration to set. The client MUST set the appropriate flag in the FieldControl member for any data field in pConfig that is to be set by the server.

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

0x00000002

ERROR_FILE_NOT_FOUND

The system cannot find the specified file.

0x00000005

ERROR_ACCESS_DENIED

Access is denied.

0x00000426

ERROR_SERVICE_NOT_ACTIVE

The service is not running.

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 SHOULD set the configurable properties in pConfig into the configuration store for the Internet protocol server specified by dwServerMask.

The server MUST NOT access a field value in pConfig unless the corresponding flag in the FieldControl field is set.

The implementation MAY choose not to save some fields of the INET_INFO_CONFIG_INFO structure. If so, the server MUST ignore the field values sent by the client.

The implementation MAY return an error if it is unable to persist a field value due to some internal error.