DsReplicaVerifyObjectsW function (ntdsapi.h)

Article
02/22/2024

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

Syntax

NTDSAPI DWORD DsReplicaVerifyObjectsW(
  [in] HANDLE     hDS,
  [in] LPCWSTR    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