3.1.4 Message Processing Events and Sequencing Rules

  • Article

The Message Queuing (MSMQ): Directory Service Protocol SHOULD indicate to the RPC runtime that it is to perform a strict NDR data consistency check at target level 6.0, as specified in [MS-RPCE] section 3.<14>

This protocol MUST indicate to the RPC runtime that it is to reject a NULL unique or full pointer with nonzero conformant value, as specified in [MS-RPCE] section 3.

The server SHOULD enforce appropriate security measures to make sure that the caller has the required permissions to execute the following routines.

The methods specified as follows MUST NOT throw exceptions.

The following methods comprise the dscomm server interface.

Methods in RPC Opnum Order

Method

Description

S_DSCreateObject

Creates a directory object.

Opnum: 0

S_DSDeleteObject

Deletes a directory object specified by a directory service pathname.

Opnum: 1

S_DSGetProps

Returns properties associated with a directory object specified by a directory service pathname.

Opnum: 2

S_DSSetProps

Sets properties associated with a directory object specified by a directory service pathname.

Opnum: 3

S_DSGetObjectSecurity

Returns security properties associated with a directory object specified by a directory service pathname.

Opnum: 4

S_DSSetObjectSecurity

Sets security properties associated with a directory object specified by a directory service pathname.

Opnum: 5

S_DSLookupBegin

Begins a directory query to enumerate directory objects matching selection criteria.

Opnum: 6

S_DSLookupNext

Returns the next item in a directory query result set.

Opnum: 7

S_DSLookupEnd

Ends a directory query and closes the RPC context handle acquired from a previous call to S_DSLookupBegin.

Opnum: 8

Opnum9NotUsedOnWire

Reserved for local use.

Opnum: 9

S_DSDeleteObjectGuid

Deletes a directory object specified by object identifier.

Opnum: 10

S_DSGetPropsGuid

Returns properties associated with a directory object specified by object identifier.

Opnum: 11

S_DSSetPropsGuid

Sets property identifiers associated with a directory object specified by object identifier.

Opnum: 12

S_DSGetObjectSecurityGuid

Returns security properties associated with a directory object specified by object identifier.

Opnum: 13

S_DSSetObjectSecurityGuid

Sets security properties associated with a directory object specified by object identifier.

Opnum: 14

Opnum15NotUsedOnWire

Reserved for local use.

Opnum: 15

Opnum16NotUsedOnWire

Reserved for local use.

Opnum: 16

Opnum17NotUsedOnWire

Reserved for local use.

Opnum: 17

Opnum18NotUsedOnWire

Reserved for local use.

Opnum: 18

S_DSQMSetMachineProperties

Sets the properties of the MSMQ machine object in the directory service.

Opnum: 19

S_DSCreateServersCache

Returns a list of BSCs associated with the site the caller is in.

Opnum: 20

S_DSQMGetObjectSecurity

Returns the security properties for the specified machine object.

Opnum: 21

S_DSValidateServer

Initiates an authentication handshake to authenticate the directory server to the client.

Opnum: 22

S_DSCloseServerHandle

Closes an RPC context handle acquired from a previous call to S_DSValidateServer.

Opnum: 23

 Opnum24NotUsedOnWire

Reserved for local use.

Opnum: 24

 Opnum25NotUsedOnWire

Reserved for local use.

Opnum: 25

 Opnum26NotUsedOnWire

Reserved for local use.

Opnum: 26

S_DSGetServerPort

Returns the port number assigned for the RPC dynamic endpoint.

Opnum: 27

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