[MS-DFSRH]: DFS Replication Helper Protocol Specification

• Files in the staging folder. For the staging folder, the server MUST count only the cumulativesize of the files and specify -1 instead of the count of files.If an error is encountered while the server is getting the information listed above, the server MAYchoose to abort further processing and return the implementation-specific error to the client.Alternatively, the server MAY choose to proceed with getting other health information and to excludefrom the report the information that it was unable to collect.3.1.5.4.2 GetCompressedReport Method (Opnum 4)The GetCompressedReport method gets the health information for the specified replication groupthat is hosted on the server in addition to the global health data of the DFS-R service on the server.HRESULT GetCompressedReport([in] GUID replicationGroupGuid,[in] BSTR referenceMember,[in] SAFEARRAY(_VersionVectorData)* referenceVersionVectors,[in] long flags,[out] SAFEARRAY(_VersionVectorData)* memberVersionVectors,[out] BSTR* reportCompressed,[out] long* uncompressedReportSize);replicationGroupGuid: MUST be the identifier of the replication group for which the server getshealth information. This field corresponds to the objectGUID field of the msDFSR-ReplicationGroup configuration object in Active Directory. The msDFSR-ReplicationGroup isspecified in [MS-FRS2] section 2.2.3.5.referenceMember: If the flags parameter has REPORTING_FLAGS_BACKLOG set, thisparameter MUST be set to the name of the reference member. Otherwise, this parameterMUST be set to NULL.referenceVersionVectors: If the flags parameter has REPORTING_FLAGS_BACKLOG set, theset of version vectors for replicated folders on the reference member MUST be passed byusing this parameter. Otherwise, this parameter MUST be set to NULL. TheVersionVectorData structure is specified in section 2.2.1.4.flags: MUST be zero or more combinations of values of DfsrReportingFlags enumeration. TheDfsrReportingFlags enumeration is specified in section 2.2.1.2.memberVersionVectors: If the flags parameter has REPORTING_FLAGS_BACKLOG set, the setof version vectors for the replicated folders on the server together with outgoing MUST bereturned in this output parameter. The VersionVectorData structure is specified in section2.2.1.4.reportCompressed: The compressed report body in the XML format MUST be returned in thisoutput parameter. The format of the XML MUST be the same as for the reportXML member ofthe GetReport method. This MUST be an encoded field whose format is specified by theWindows Server 2003 decompression algorithm in [MS-DRSR] section 4.1.10.2.13.uncompressedReportSize: The size, in bytes, of the uncompressed data returned in thereportCompressed paramater.Return Values: The method MUST return zero on success, or an implementation-specificnonzero HRESULT error code, as specified in [MS-ERREF] section 2.1, between 0x80000000[MS-DFSRH] – v20080207DFS Replication Helper Protocol SpecificationCopyright © 2008 Microsoft Corporation.Release: Thursday, February 7, 200863 / 81