3.1.5.3 R_InetInfoGetSites (Opnum 2)

  • Article

The R_InetInfoGetSites method is called by the client. In response, the server retrieves a list of server instances for the specified Internet protocol server.

 DWORD R_InetInfoGetSites(
   [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer,
   [in] DWORD dwServerMask,
   [out] LPINET_INFO_SITE_LIST* ppSites
 );

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.

ppSites: The pointer to a pointer to INET_INFO_SITE_LIST that specifies the list of defined server instances for the Internet protocol server specified by dwServerMask.

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

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 return a list of defined server instances in ppSites if the return code indicates success.<10>