3.1.4 Message Processing Events and Sequencing Rules

This DCOM interface inherits the IUnknown interface. Method opnum field values start with 3; opnum values 0 through 2 represent the IUnknown_QueryInterface, IUnknown_AddRef, and IUnknown_Release methods, respectively, as specified in [MS-DCOM].

Methods with opnum field values 34 through 39 are defined in section 3.3.4, and field value 40 is defined in section 3.5.4.

This protocol MUST indicate to the RPC runtime that it is to perform a strict Network Data Representation (NDR) data consistency check at target level 5.0, as specified in [MS-RPCE] section 3.

Methods in RPC Opnum Order

Method

Description

AddKey

Creates a node and adds it to the metabase as a subnode of an existing node at the specified path.

Opnum: 3

DeleteKey

Deletes a node and all its data from the metabase. All of the node's subnodes are recursively deleted.

Opnum: 4

DeleteChildKeys

Deletes all subnodes of the specified node and any data they contain. It also recursively deletes all nodes below the subnodes.

Opnum: 5

EnumKeys

Enumerates the subnodes of the specified node.

Opnum: 6

CopyKey

Copies or moves a node, including its subnodes and data, to a specified destination. The copied or moved node becomes a subnode of the destination node.

Opnum: 7

RenameKey

Renames a node in the metabase.

Opnum: 8

R_SetData

Sets a data item for a particular node in the metabase.

Opnum: 9

R_GetData

Returns a data entry from a particular node in the metabase.

Opnum: 10

DeleteData

Deletes specific data entries from a node in the metabase.

Opnum: 11

R_EnumData

Enumerates the data entries of a node in the metabase.

Opnum: 12

R_GetAllData

Returns all data associated with a node in the metabase, including all values that the node inherits.

Opnum: 13

DeleteAllData

Deletes all or a subset of local data associated with a particular node.

Opnum: 14

CopyData

Copies or moves data between nodes.

Opnum: 15

GetDataPaths

Returns the paths of all nodes in the subtree relative to a specified starting node that contains the supplied identifier.

Opnum: 16

OpenKey

Opens a node for read access, write access, or both. The returned handle can be used by several of the other methods in IMSAdminBaseW.

Opnum: 17

CloseKey

Closes a handle to a node.

Opnum: 18

ChangePermissions

Changes permissions on an open handle.

Opnum: 19

SaveData

Explicitly saves the metabase data to disk.

Opnum: 20

GetHandleInfo

Returns information associated with the specified metabase handle.

Opnum: 21

GetSystemChangeNumber

Returns the number of changes made to data since the metabase was created.

Opnum: 22

GetDataSetNumber

Returns all the data set numbers associated with a node in the metabase.

Opnum: 23

SetLastChangeTime

Sets the last change time associated with a node in the metabase.

Opnum: 24

GetLastChangeTime

Returns the last change time associated with a node in the metabase.

Opnum: 25

R_KeyExchangePhase1

Receives a pair of encrypted client nodes and returns server encryption and session keys.

Opnum: 26

R_KeyExchangePhase2

Receives the encrypted client session and hash keys in response to R_KeyExchangePhase1 and returns the encrypted server hash keys.

Opnum: 27

Backup

Backs up the metabase to a specified location.

Opnum: 28

Restore

Restores the metabase from a backup.

Opnum: 29

EnumBackups

Enumerates the metabase backups in a specified backup location, or in all backup locations.

Opnum: 30

DeleteBackup

Deletes a metabase backup from a backup location.

Opnum: 31

UnmarshalInterface

Unmarshals a reference to the IMSAdminBaseW interface.

Opnum: 32

R_GetServerGuid

Returns the GUID for the IIS instance that is running.

Opnum: 33

Structures

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

Structure

Description

METADATA_HANDLE_INFO

Defines information about a handle to a metabase entry.

METADATA_RECORD

Defines information about a metabase entry.

METADATA_GETALL_RECORD

Defines an analogous structure to METADATA_RECORD but is used only to return data from a call to the R_GetAllData method.

IIS_CRYPTO_BLOB

Defines a block of opaque data, possibly encrypted, for RPC marshaling between IIS and a client.