DsReplicaGetInfo2W-Funktion (ntdsapi.h)
Die DsReplicaGetInfo2-Funktion ruft Replikationsstatusdaten aus dem Verzeichnisdienst ab. Diese Funktion ermöglicht das Paging von Ergebnissen in Fällen, in denen mehr als 1.000 Einträge abgerufen werden können.
NTDSAPI DWORD DsReplicaGetInfo2W(
[in] HANDLE hDS,
[in] DS_REPL_INFO_TYPE InfoType,
[in, optional] LPCWSTR pszObject,
[in, optional] UUID *puuidForSourceDsaObjGuid,
[in, optional] LPCWSTR pszAttributeName,
[in, optional] LPCWSTR pszValue,
[in] DWORD dwFlags,
[in] DWORD dwEnumerationContext,
[out] VOID **ppInfo
);
[in] hDS
Enthält ein Verzeichnisdiensthandle, das von der FUNKTION DSBind oder DSBindWithCred 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.
[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 sind mögliche Wertcodes aufgeführt.
pszObject identifiziert den Namenskontext, für den Replikationsnachbarn angefordert werden.
pszObject identifiziert den Benennungskontext, 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.
pszObject identifiziert das Objekt, für das Attributreplikationsmetadaten angefordert werden.
pszObject identifiziert das Objekt, für das Replikationsmetadaten angefordert werden.
pszObject identifiziert das Objekt, für das Attributreplikationsmetadaten angefordert werden.
[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 dem angegebenen objectGuid im Verzeichnis entsprechen. Dieser Parameter wird ignoriert, wenn NULL oder der InfoType-Parameter etwas anderes als DS_REPL_INFO_NEIGHBORS ist.
[in, optional] pszAttributeName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des spezifischen Attributs enthält, für das Replikationsdaten abgerufen werden sollen.
Dieser Parameter wird nur verwendet, wenn der InfoType-Parameter einen der folgenden Werte enthält.
[in, optional] pszValue
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den wertigen Namen enthält, der übereinstimmen soll. Wenn das angeforderte Attribut ein Distinguished Name Type-Wert ist, gibt diese Funktion die Attribute zurück, die den angegebenen Wert enthalten.
[in] dwFlags
Enthält eine Reihe von Flags, die das Verhalten der Funktion ändern. Dieser Parameter kann null oder der folgende Wert sein.
Bewirkt, dass die Attributmetadaten Metadaten für die verknüpften Werte des Attributs berücksichtigen. Der resultierende Vektor stellt Änderungen für alle Attribute dar. Dieser geänderte Vektor ist nützlich für Clients, die erwarten, dass alle Attribute und Metadaten in den Attributmetadatenvektor einbezogen werden.
[in] dwEnumerationContext
Enthält den Index des nächsten abzurufenden Eintrags. Dieser Parameter muss beim ersten Aufruf dieser Funktion auf Null festgelegt werden.
Dieser Parameter wird nur verwendet, wenn der InfoType-Parameter einen der folgenden Werte enthält.
Diese Funktion ruft maximal 1.000 Einträge für jeden Aufruf ab. Wenn nach dem Aufrufen dieser Funktion weitere Einträge verfügbar sind, enthält das dwEnumerationContext-Element der abgerufenen Struktur den Index des nächsten abzurufenden Eintrags. Das dwEnumerationContext-Element der abgerufenen Struktur wird dann als dwEnumerationContext-Parameter beim nächsten Aufruf dieser Funktion verwendet. Wenn alle Einträge abgerufen wurden, enthält das dwEnumerationContext-Element der abgerufenen Struktur -1. Wenn -1 für diesen Parameter übergeben wird, gibt diese Funktion ERROR_NO_MORE_ITEMS zurück.
[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 Er DsReplicaFreeInfo aufruft.
Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder andernfalls ein Win32- oder RPC-Fehler auftritt. Im Folgenden sind mögliche Fehlercodes aufgeführt.
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 |