The DsReplicaUpdateRefs function adds or removes a replication reference for a destination from a source naming context.
NTDSAPI DWORD DsReplicaUpdateRefsA( HANDLE hDS, LPCSTR NameContext, LPCSTR DsaDest, const UUID *pUuidDsaDest, ULONG Options );
Pointer to a constant null-terminated string that specifies the distinguished name of the source naming context.
Pointer to a constant null-terminated string that specifies the transport-specific address of the destination directory system agent.
Pointer to a UUID value that contains the destination directory system agent.
Contains a set of flags that provide additional data used to process the request. This can be zero or a combination of one or more of the following values.
A reference to the destination is added to the source server.
The operation is performed asynchronously.
A reference to the destination is removed from the source server.
The reference to the replica added or removed is writable. Otherwise, it is read-only.
If the function succeeds, ERROR_SUCCESS is returned.
If the function fails, the return value can be one of the following.
If both DS_REPUPD_ADD_REFERENCE and DS_REPUPD_DELETE_REFERENCE are set in the Options parameter, a reference to the destination is added if one does not already exist on the server. If a reference to the destination already exists, the reference is updated.
|Minimum supported client||Windows Vista|
|Minimum supported server||Windows Server 2008|