DsReplicaVerifyObjectsA function (ntdsapi.h)

The DsReplicaVerifyObjects function verifies all objects for a naming context with a source.

Syntax

NTDSAPI DWORD DsReplicaVerifyObjectsA(
  [in] HANDLE     hDS,
  [in] LPCSTR     NameContext,
  [in] const UUID *pUuidDsaSrc,
  [in] ULONG      ulOptions
);

Parameters

[in] hDS

Contains a directory service handle obtained from either the DSBind, DSBindWithCred, or DsBindWithSpn function.

[in] NameContext

Pointer to a null-terminated string that contains the distinguished name of the naming context.

[in] pUuidDsaSrc

Pointer to a UUID value that contains the objectGuid of the directory system agent object.

[in] ulOptions

Contains a set of flags that modify the behavior of the function. This can be zero or the following value.

DS_EXIST_ADVISORY_MODE

Do not delete objects in response to this function.

Return value

Returns ERROR_SUCCESS if successful or a Win32 error otherwise. Possible error values include the following.

Remarks

Note

The ntdsapi.h header defines DsReplicaVerifyObjects as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header ntdsapi.h
Library Ntdsapi.lib
DLL Ntdsapi.dll

See also

Domain Controller and Replication Management Functions

DsBind

DsBindWithCred

DsBindWithSpn