DsReplicaUpdateRefs function
The DsReplicaUpdateRefs function adds or removes a replication reference for a destination from a source naming context.
Syntax
DWORD DsReplicaUpdateRefs(
_In_ HANDLE hDS,
_In_ LPCTSTR NameContext,
_In_ LPCTSTR DsaDest,
_In_ const UUID *pUuidDsaDest,
_In_ ULONG Options
);
Parameters
- hDS [in]
-
Contains a directory service handle obtained from either the DSBind or DSBindWithCred function.
- NameContext [in]
-
Pointer to a constant null-terminated string that specifies the distinguished name of the source naming context.
- DsaDest [in]
-
Pointer to a constant null-terminated string that specifies the transport-specific address of the destination directory system agent.
- pUuidDsaDest [in]
-
Pointer to a UUID value that contains the destination directory system agent.
- Options [in]
-
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.
Return value
If the function succeeds, ERROR_SUCCESS is returned.
If the function fails, the return value can be one of the following.
- ERROR_INVALID_PARAMETER
-
One or more parameters are invalid.
- ERROR_NOT_SUPPORTED
-
Reserved for future use.
Remarks
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.
Requirements
|
Minimum supported client |
Windows Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names |
DsReplicaUpdateRefsW (Unicode) and DsReplicaUpdateRefsA (ANSI) |
See also
- Domain Controller and Replication Management Functions
- DsReplicaAdd
- DsReplicaDel
- DsReplicaModify
- DsReplicaSync