3.3.4.4 FrsRpcSendCommPkt (Opnum 0)

  • Article

The FrsRpcSendCommPkt method transfers change order commands, files, and folders on an FRS connection.

 unsigned long FrsRpcSendCommPkt(
   [in] handle_t Handle,
   [in] PCOMM_PACKET CommPkt
 );

Handle: Binding handle obtained when the partner authenticates with the FRS.

CommPkt: Command and data sent from the replication partner.

Return Values: The method MUST return 0 on success or a nonzero error code on failure. For protocol purposes, all nonzero values MUST be treated as equivalent failures unless otherwise specified.

Return value/code

Description

0x00000000

ERROR_SUCCESS

The method completed successfully.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

FRS uses FrsRpcSendCommPkt to send COMM_PACKET objects (see section 2.2.3.5) between replica members to replicate files and folders inside a Replica Set. See sections 4.1 and 4.2.

In the following section, these two sentences have the same meaning:

  • Machine A sends a COMM_PACKET to machine B.

  •  Machine A calls the FrsRpcSendCommPkt method on machine B.

There are 12 types of COMM_PACKETs (see section 2.2.3.6.2). If machine A sends a COMM_PACKET packet to machine B with COMM_PACKET.COMM_COMMAND set to CMD_XXXX, a simple way to describe this is as follows: Machine A sends CMD_XXXX to machine B.