Compartilhar via


3.1.4 Message Processing Events and Sequencing Rules

The Witness interface defines the following methods:

Method

Description

WitnessrGetInterfaceList

The WitnessrGetInterfaceList method returns information about the interfaces to which witness client connections can be made.

Opnum: 0

WitnessrRegister

The WitnessrRegister method allows the witness client to register for notifications from the server.

Opnum: 1

WitnessrUnRegister

The WitnessrUnRegister method allows the client to unregister for notifications from the server.

Opnum: 2

WitnessrAsyncNotify

The WitnessrAsyncNotify method is used by the client to request notification of resource changes from the server.

Opnum: 3

WitnessrRegisterEx

The WitnessrRegisterEx method allows the witness client to register for notifications from the server for a specific share and with optional flags. This opnum is only applicable for Witness protocol version 2.

Opnum: 4

WitnessrUnRegisterEx

The WitnessrUnRegisterEx method allows the client to unregister for notifications from the server.<3> The Witness Service removes its internal state of the registration and no longer notifies the client in the event of any resource state changes. This opnum is only applicable for Witness protocol version 2.

Opnum: 5

For all methods, the server SHOULD<4> enforce security measures to verify that the caller has the required permissions to execute any method. If the server enforces security measures, and the caller does not have the required credentials, then the server MUST fail the call and return ERROR_ACCESS_DENIED. For more details about how to determine the identity of the caller for the purpose of performing an access check, see [MS-RPCE] section 3.3.3.1.3.