R_IISEnumerateUsers (Opnum 14)

The R_IISEnumerateUsers method is called by the client. In response, the server returns a list of clients connected to the specified Internet protocol server.

 DWORD R_IISEnumerateUsers(
   [in, string, unique] INET_INFO_IMPERSONATE_HANDLE pszServer,
   [in] DWORD dwServiceId,
   [in] DWORD dwInstance,
   [in, out] LPIIS_USER_ENUM_STRUCT InfoStruct

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.

dwServiceId: The identifier for the specified Internet protocol server, as specified in section 2.2.2.

dwInstance: The ID of the Internet protocol server instance whose users are being enumerated.

InfoStruct: The pointer to an IIS_USER_ENUM_STRUCT that contains the list of active users for this 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




The system cannot find the specified file.



Access is denied.



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 MAY return a list of the clients connected to the protocol server if the return code indicates success.<15>