Directory Services

DsReplicaVerifyObjects

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

DWORD WINAPI DsReplicaVerifyObjects(
  HANDLE hDS,
  LPCTSTR NameContext,
  const UUID* pUuidDsaSrc,
  ULONG ulOptions
);

Parameters

hDS
[in] Contains a bind handle to the directory service. This handle is provided by a call to DsBind, DsBindWithCred, or DsBindWithSpn.
NameContext
[in] Pointer to a null-terminated string that contains the distinguished name of the of the naming context.
pUuidDsaSrc
[in] Pointer to a UUID value that contains the objectGuid of the directory system agent object.
ulOptions
[in] Contains a set of flags that modify the behavior of the function. This can be zero or the following value.
Value Meaning
DS_EXIST_ADVISORY_MODE Do not delete objects in response to this function.

Return Values

Returns ERROR_SUCCESS if successful or a Win32 error otherwise. Possible error values include the following.
Return Code Description
ERROR_INVALID_PARAMETER One or more parameters are invalid.
ERROR_NOT_SUPPORTED The server does not support this operation.
ERROR_DS_DRA_BAD_NC The naming context, identified by the NameContext parameter, is invalid.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Unicode: Implemented only as ANSI and Unicode.
Header: Declared in Ntdsapi.h.
Library: Use Ntdsapi.lib.

See Also

DsBind, DsBindWithCred, DsBindWithSpn, Domain Controller and Replication Management Functions