3.2.4 Message Processing Events and Sequencing Rules

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 6.0, as specified in section 3 of [MS-RPCE].

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 section 3 of [MS-RPCE].

The server MUST fail a method with error 0x80070548 (ERROR_INVALID_SERVER_STATE) if the server's Prepare State (3.2.1) is not correct for that method. The required Prepare State is as follows:

• CprepPrepareNode (section 3.2.4.3) requires Prepare State Initial.

• CprepPrepareNodePhase2 (section 3.2.4.4) requires Prepare State Preparing.

• All other methods require Prepare State Online.

Once the server's Prepare State is Online, it remains Online until the DCOM object exporter removes the application-specific state associated with the IClusterStorage2 interface, as specified in [MS-DCOM] section 1.3.6.

A ClusPrepDisk object has three state variables, as specified in section 3.2.1: ClusPrepDisk.AttachedState, ClusPrepDisk.OwnedState, and ClusPrepDisk.OnlineState. These states are related as follows:

• ClusPrepDisk.AttachedState MUST be Attached in order for ClusPrepDisk.OwnedState to be OwnedByThisServer.

• ClusPrepDisk.OwnedState MUST be OwnedByThisServer in order for ClusPrepDisk.OnlineState to be Online.

Methods in the protocol that take a CPREP_DISKID (section 2.2.2) as an input parameter have requirements on the values of ClusPrepDisk.AttachedState, ClusPrepDisk.OwnedState, and ClusPrepDisk.OnlineState. The server MUST accept the following methods regardless of the values of ClusPrepDisk.AttachedState, ClusPrepDisk.OwnedState, and ClusPrepDisk.OnlineState:

• CprepDiskGetProps (section 3.2.4.5)

• CprepDiskGetUniqueIds (section 3.2.4.13)

• CprepDiskAttach (section 3.2.4.14)

• CprepDiskGetUniqueIds3 (section 3.4.4.1)

For the following methods, the server MUST require that the value of ClusPrepDisk.AttachedState is equal to Attached:

• CprepDiskRawRead (section 3.2.4.1)

• CprepDiskRawWrite (section 3.2.4.2)

• CprepDiskVerifyUnique (section 3.2.4.8)

• CprepDiskPRArbitrate (section 3.2.4.15)

• CprepDiskPRRegister (section 3.2.4.16)

• CprepDiskPRUnRegister (section 3.2.4.17)

• CprepDiskPRReserve (section 3.2.4.18)

• CprepDiskPRRelease (section 3.2.4.19)

• CprepDiskGetArbSectors (section 3.2.4.21)

• CprepDiskIsPRPresent (section 3.2.4.22)

• CprepDiskPRPreempt (section 3.2.4.23)

• CprepDiskPRClear (section 3.2.4.24)

• CprepDiskIsOnline (section 3.2.4.25)

• CprepDiskIsReadable (section 3.2.4.28)

• CprepDiskPRRegister3 (section 3.4.4.9)

• CprepDiskFindKey3 (section 3.4.4.10)

• CprepDiskPRPreempt3 (section 3.4.4.11)

• CprepDiskPRReserve3 (section 3.4.4.12)

• CprepDiskIsPRPresent3 (section 3.4.4.13)

• CprepDiskPRRelease3 (section 3.4.4.14)

• CprepDiskPRClear3 (section 3.4.4.15)

For the following methods, the server MUST additionally require that the value of ClusPrepDisk.OwnedState is equal to OwnedByThisServer:

• CprepDiskStopDefense (section 3.2.4.6)

• CprepDiskOnline (section 3.2.4.7)

• CprepDiskSetOnline (section 3.2.4.26)

For the following methods, the server MUST additionally require that the value of ClusPrepDisk.OnlineState is equal to Online:

• CprepDiskWriteFileData (section 3.2.4.9)

• CprepDiskVerifyFileData (section 3.2.4.10)

• CprepDiskDeleteFile (section 3.2.4.11)

• CprepDiskOffline (section 3.2.4.12)

• CprepDiskDiskPartitionIsNtfs (section 3.2.4.20)

• CprepDiskGetFSName (section 3.2.4.27)

For methods that take a CPREP_DISKID (section 2.2.2) as an input parameter, the server MUST look in the ClusPrepDiskList for a ClusPrepDisk object that matches the CPREP_DISKID input parameter. If no such object is found, the server SHOULD<12> return 0x80070002 (ERROR_FILE_NOT_FOUND). If the CPREP_DISKID provided by the client matches more than one ClusPrepDisk in the server's ClusPrepDiskList, then the server SHOULD execute the method for one of the matching ClusPrepDisk objects. The matching ClusPrepDisk that the server chooses is arbitrary and implementation-specific.

For those methods listed previously that take a CPREP_DISKID as an input parameter and require that ClusPrepDisk.AttachedState is equal to Attached (or that ClusPrepDisk.OwnedState is equal to OwnedByThisServer or that ClusPrepDisk.OnlineState is equal to Online), the server SHOULD<13> fail the method with 0x8007139F (ERROR_INVALID_STATE) if the matching ClusPrepDisk.AttachedState is not equal to Attached.

For those methods listed previously that take a CPREP_DISKID as an input parameter and require that ClusPrepDisk.OwnedState is equal to OwnedByThisServer (or that ClusPrepDisk.OnlineState is equal to Online), the server MUST fail with error 0x8007139F (ERROR_INVALID_STATE) if the matching ClusPrepDisk.OwnedState is not equal to OwnedByThisServer.

For those methods listed previously that take a CPREP_DISKID as an input parameter and require that ClusPrepDisk.OnlineState is equal to Online, the server MUST fail with error 0x8007139F (ERROR_INVALID_STATE) if the matching ClusPrepDisk.OnlineState is not equal to Online.

For those methods that take a ulPartition as the partition number, the server MUST use an implementation-specific mechanism to map the partition identified by ulPartition to a volume. If ulPartition cannot be mapped to a volume, then the server MUST return ERROR_FILE_NOT_FOUND.

For those methods that access a volume through a file system, the server MUST use an implementation-specific mechanism to verify that the volume contains a file system. If the volume does not contain a file system, then the server MUST return ERROR_UNRECOGNIZED_VOLUME.

All methods MUST NOT throw exceptions.

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] section 3.1.1.5.8.

Methods in RPC Opnum Order