DsReplicaGetInfoW-Funktion (ntdsapi.h)
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 |