3.1.5.4.4 GetReferenceVersionVectors Method (Opnum 6)

  • Article

The GetReferenceVersionVectors method gets the version vectors for all replicated folders in the specified replication group.

 HRESULT GetReferenceVersionVectors(
   [in] GUID replicationGroupGuid,
   [out] SAFEARRAY (_VersionVectorData)* referenceVersionVectors
 );

replicationGroupGuid: MUST be the identifier of the replication group for which the server gets version vectors.

referenceVersionVectors: MUST be the array of version vectors for the replicated folders on the server. MUST be returned in this output parameter. For more information, see section 2.2.1.4.

Return Values: The method MUST return zero on success or return an implementation-specific nonzero HRESULT error code, as specified in [MS-ERREF] section 2.1, between 0x80000000 and 0xFFFFFFFF on failure. For protocol purposes, all nonzero values MUST be treated as equivalent failures.

Upon receiving this message, the server MUST get all version vectors for replicated folders in the replication group with the GUID that is specified by replicationGroupGuid. <61>

The server MUST save information about these version vectors in the referenceVersionVectors output parameter and return zero to indicate success. If failure, the referenceVersionVectors output parameter MUST be set to contain a NULL pointer value for the SAFEARRAY and return a failure HRESULT error code in the range (0x80000000 – 0xFFFFFFFF).

The server MUST return the response to the client. The response MUST contain the output parameters previously described for this method, and the status of the operation.