3.1.5 Message Processing Events and Sequencing Rules

  • Article

The remainder of this section describes the server behavior for the RPC methods on the inetinfo interface that makes up the IIS Inetinfo Remote Protocol. IIS Inetinfo Remote Protocol clients can invoke the RPC methods that are specified in this section in any order after an Internet Information Services (IIS) Inetinfo Remote Protocol session is established with the server. The outcome of the calls depends on the parameters that are passed to each of those calls and not on a particular call sequence or state maintained across method invocations.

Methods in RPC Opnum Order

Method

Description

R_InetInfoGetVersion

Called by the client. In response, the server returns its version information.

Opnum: 0

R_InetInfoGetAdminInformation

Called by the client. In response, the server returns configuration data for the specified Internet protocol server.

Opnum: 1

R_InetInfoGetSites

Called by the client. In response, the server retrieves a list of service instances for the specified Internet protocol server.

Opnum: 2

R_InetInfoSetAdminInformation

Called by the client. In response, the server sets configurable properties for the specified Internet protocol server.

Opnum: 3

R_InetInfoGetGlobalAdminInformation

Called by the client. In response, the server retrieves configuration data shared by all Internet protocol servers.

Opnum: 4

R_InetInfoSetGlobalAdminInformation

Called by the client. In response, the server sets configuration data shared by all Internet protocol servers.

Opnum: 5

R_InetInfoQueryStatistics

Called by the client. In response, the server retrieves statistical data for the specified Internet protocol server.

Opnum: 6

R_InetInfoClearStatistics

Called by the client. In response, the server resets the statistical data maintained by the specified Internet protocol server.

Opnum: 7

R_InetInfoFlushMemoryCache

Called by the client. In response, the server flushes data from the internal caches of the specified Internet protocol server.

Opnum: 8

R_InetInfoGetServerCapabilities

Called by the client. In response, the server returns information on the features of the Internet protocol servers and the host operating system.

Opnum: 9

R_W3QueryStatistics2

Called by the client. In response, the server returns statistical data from the HTTP server.

Opnum: 10

R_W3ClearStatistics2

Called by the client. In response, the server resets statistical data for the HTTP server.

Opnum: 11

R_FtpQueryStatistics2

Called by the client. In response, the server returns statistical data from the FTP server.

Opnum: 12

R_FtpClearStatistics2

Called by the client. In response, the server resets statistical data for the FTP server.

Opnum: 13

R_IISEnumerateUsers

Called by the client. In response, the server returns a list of clients connected to the specified Internet protocol server.

Opnum: 14

R_IISDisconnectUser

Called by the client. In response, the server disconnects the specified user from the specified Internet protocol server.

Opnum: 15

Opnum16NotUsedOnWire

Reserved for local use.

Opnum: 16

Opnum17NotUsedOnWire

Reserved for local use.

Opnum: 17

Structures

The Message Processing Events and Sequencing Rules interface defines the following structures.

Structure

Description

INET_INFO_CONFIG_INFO

This structure stores configuration values for an Internet protocol server.

INET_LOG_CONFIGURATION

This structure contains configuration information for Internet protocol server logging.

INET_INFO_IP_SEC_LIST

This structure contains a list of INET_INFO_IP_SEC_ENTRY entries.

INET_INFO_IP_SEC_ENTRY

This structure contains Internet protocol security (IPv4) entries.

INET_INFO_VIRTUAL_ROOT_LIST

This structure contains a list of INET_INFO_VIRTUAL_ROOT_ENTRY virtual root entries.

INET_INFO_VIRTUAL_ROOT_ENTRY

This structure contains data describing a virtual root for the Internet protocol server instance.

INET_INFO_SITE_LIST

This structure contains a list of INET_INFO_SITE_ENTRY site entries.

INET_INFO_SITE_ENTRY

This structure contains information describing an Internet protocol server instance.

INET_INFO_GLOBAL_CONFIG_INFO

This structure contains configuration data global to all the Internet protocol services managed by this protocol.

INET_INFO_STATISTICS_0

This structure contains statistics for an Internet protocol server.

INETA_ATQ_STATISTICS

This structure contains network I/O statistics and client connection information for an Internet protocol server.

INETA_CACHE_STATISTICS

This structure contains statistics for the Internet protocol server's caches.

INET_INFO_CAPABILITIES_STRUCT

This structure specifies the features supported by an Internet protocol server implementation.

INET_INFO_CAP_FLAGS

This structure contains information on features that are available for a protocol server.

W3_STATISTICS_1

This structure contains statistics on the usage of the HTTP server.

FTP_STATISTICS_0

This structure contains statistics on the usage of the FTP server.

IIS_USER_ENUM_STRUCT

This structure contains a pointer to an IIS_USER_INFO_1_CONTAINER.

IIS_USER_INFO_1_CONTAINER

This structure contains a list of IIS_USER_INFO_1 structures describing users who are actively connected to the Internet protocol server.

IIS_USER_INFO_1

This structure describes a user connected to an Internet protocol server.

Unions

The Message Processing Events and Sequencing Rules interface defines the following unions.

Union

Description

INET_INFO_STATISTICS_INFO

This union contains a pointer to an INET_INFO_STATISTICS_0 structure.

W3_STATISTICS_STRUCT

This union contains a pointer to a W3_STATISTICS_1 structure.

FTP_STATISTICS_STRUCT

This union contains a pointer to an FTP_STATISTICS_0 structure.

In the preceding tables, "Reserved for local use" means that the client MUST NOT send the opnum, and the server behavior is undefined because it does not affect interoperability.<8>