DsReplicaGetInfoW-Funktion (ntdsapi.h)

Artikel
08/25/2023

Die DsReplicaGetInfo-Funktion ruft Replikationsstatusdaten aus dem Verzeichnisdienst ab.

Syntax

NTDSAPI DWORD DsReplicaGetInfoW(
  [in]           HANDLE            hDS,
  [in]           DS_REPL_INFO_TYPE InfoType,
  [in, optional] LPCWSTR           pszObject,
  [in, optional] UUID              *puuidForSourceDsaObjGuid,
  [out]          VOID              **ppInfo
);

Parameter

[in] hDS

Enthält ein Verzeichnisdiensthandle, das von der DSBind - oder DSBindWithCred-Funktion abgerufen wurde.

[in] InfoType

Enthält einen der DS_REPL_INFO_TYPE-Werte , der den Typ der abzurufenden Replikationsdaten angibt. Dieser Wert bestimmt auch, welcher Strukturtyp in ppInfo zurückgegeben wird.

Für diese Funktion werden nur die folgenden Werte unterstützt. Wenn andere Datentypen erforderlich sind, muss die DsReplicaGetInfo2-Funktion verwendet werden.

DS_REPL_INFO_NEIGHBORS

DS_REPL_INFO_CURSORS_FOR_NC

DS_REPL_INFO_METADATA_FOR_OBJ

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

DS_REPL_INFO_PENDING_OPS

[in, optional] pszObject

Zeiger auf eine konstante Unicode-Zeichenfolge mit NULL-Beendigung, die das Objekt identifiziert, für das Replikationsdaten abgerufen werden sollen. Die Bedeutung dieses Parameters hängt vom Wert des InfoType-Parameters ab. Im Folgenden finden Sie mögliche Wertcodes.

DS_REPL_INFO_NEIGHBORS

pszObject identifiziert den Namenskontext, für den Replikationsnachbarn angefordert werden.

DS_REPL_INFO_CURSORS_FOR_NC

pszObject identifiziert den Namenskontext, für den Replikationscursor angefordert werden.

DS_REPL_INFO_METADATA_FOR_OBJ

pszObject identifiziert das Objekt, für das Replikationsmetadaten angefordert werden.

DS_REPL_INFO_KCC_DSA_CONNECT_FAILURES

pszObject muss NULL sein.

DS_REPL_INFO_KCC_DSA_LINK_FAILURES

pszObject muss NULL sein.

DS_REPL_INFO_PENDING_OPS

pszObject muss NULL sein.

[in, optional] puuidForSourceDsaObjGuid

Zeiger auf einen GUID-Wert , der eine bestimmte Replikationsquelle identifiziert. Wenn dieser Parameter nicht NULL ist und der InfoType-ParameterDS_REPL_INFO_NEIGHBORS enthält, werden nur Nachbardaten für die Quelle zurückgegeben, die dem nTDSDSA-Objekt mit der angegebenen objectGuid im Verzeichnis entspricht. Dieser Parameter wird ignoriert, wenn NULL oder der InfoType-Parameter ein anderes als DS_REPL_INFO_NEIGHBORS ist.

[out] ppInfo

Adresse eines Strukturzeigers, der die angeforderten Daten empfängt. Der Wert des InfoType-Parameters bestimmt das Format dieser Struktur. Weitere Informationen und eine Liste möglicher InfoType-Werte und der entsprechenden Strukturtypen finden Sie unter DS_REPL_INFO_TYPE.

Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem DsReplicaFreeInfo aufgerufen wird.

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehler auftritt. Im Folgenden finden Sie mögliche Fehlercodes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	ntdsapi.h
Bibliothek	Ntdsapi.lib
DLL	Ntdsapi.dll