3.1.5.2 R_InetInfoGetAdminInformation (Opnum 1)
The R_InetInfoGetAdminInformation method is called by the client. In response, the server retrieves configuration data for the specified Internet protocol server.
-
DWORD R_InetInfoGetAdminInformation( [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer, [in] DWORD dwServerMask, [out] LPINET_INFO_CONFIG_INFO* ppConfig );
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.
ppConfig: The pointer to a pointer to an INET_INFO_CONFIG_INFO structure that contains configuration data for the specified Internet protocol 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.
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 MUST return the data specified in ppConfig and set the FieldControl member, as specified in INET_INFO_CONFIG_INFO.
Data returned MAY be a configuration that is persisted in a configuration store for the protocol server, runtime or derived data, or default operating values.
An implementation MAY support only a subset of the configuration data specified in the INET_INFO_CONFIG_INFO structure, but it MUST set the FieldControl member for any valid value returned.