[MS-DFSRH]: DFS Replication Helper Protocol Specification

2 Messages2.1 TransportThis protocol MUST use the DCOM Remote Protocol, as specified in [MS-DCOM], as its transport. Onits behalf, the DCOM Remote Protocol uses the following RPC protocol sequence: RPC over TCP,as specified in [MS-RPCE].To access an interface, the client MUST request a DCOM connection to its well-known object UUIDendpoint on the server, as specified in section 1.9.The RPC version number for all interfaces MUST be 0.0.An implementation of DFS Replication Helper MAY configure its DCOM implementation or underlyingRPC transport with authentication parameters to allow clients to connect, or it MAY choose to notset these parameters. The details of this are implementation-specific.The DFS Replication Helper interfaces make use of the underlying DCOM security framework, asspecified in [MS-DCOM], and rely upon it for access control. DCOM differentiates between launchand access operations and also decides whether to deny or grant access for these operations.An implementation of DFS Replication Helper MAY choose to restrict access to the interfaces.2.2 Message SyntaxIn addition to the RPC base types and the definitions that are specified in [C706] and [MS-DTYP],the sections that follow use the definitions of BSTR, GUID, SAFEARRAY, VARIANT, VARIANT_BOOL,and DWORD, as specified in [MS-DTYP] Appendix A and in [MS-DCOM]. The IServerHealthReportinterface returns its report as XML. For more information about XML, see [XML10], [XMLSCHEMA0],[XMLSCHEMA1], and [XMLSCHEMA2].2.2.1 Common Data Types2.2.1.1 DfsrHelperErrorsEnumThe DfsrHelperErrorsEnum enumeration defines error codes that are specific to the IADProxyand IADProxy2 interfaces.The UUID for this enumeration is {9009D654-250B-4e0d-9AB0-ACB63134F69F}.typedef enum DfsrHelperErrorsEnum{dfsrHelperErrorNotLocalAdmin = 0x80042001,dfsrHelperErrorCreateVerifyServerControl = 0x80042002,dfsrHelperLdapErrorBase = 0x80043000} DfsrHelperErrorsEnum;dfsrHelperErrorNotLocalAdmin: The user does not have sufficient privileges on the server.dfsrHelperErrorCreateVerifyServerControl: Cannot createLDAP_SERVER_VERIFY_NAME_OID control for the LDAP command.[MS-DFSRH] – v20080207DFS Replication Helper Protocol SpecificationCopyright © 2008 Microsoft Corporation.Release: Thursday, February 7, 200811 / 81