DsReplicaGetInfoW-Funktion (ntdsapi.h)
Die DsReplicaGetInfo-Funktion ruft Replikationsstatusdaten aus dem Verzeichnisdienst ab.
NTDSAPI DWORD DsReplicaGetInfoW(
[in] HANDLE hDS,
[in] DS_REPL_INFO_TYPE InfoType,
[in, optional] LPCWSTR pszObject,
[in, optional] UUID *puuidForSourceDsaObjGuid,
[out] VOID **ppInfo
);
[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.
[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.
pszObject identifiziert den Namenskontext, für den Replikationsnachbarn angefordert werden.
pszObject identifiziert den Namenskontext, für den Replikationscursor angefordert werden.
pszObject identifiziert das Objekt, für das Replikationsmetadaten angefordert werden.
pszObject muss NULL sein.
pszObject muss NULL sein.
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.
Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehler auftritt. Im Folgenden finden Sie mögliche Fehlercodes.
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 |