DsReplicaAddA-Funktion (ntdsapi.h)
Die DsReplicaAdd-Funktion fügt einem Zielnamenskontext einen Replikationsquellenverweis hinzu.
Syntax
NTDSAPI DWORD DsReplicaAddA(
[in] HANDLE hDS,
[in] LPCSTR NameContext,
[in] LPCSTR SourceDsaDn,
[in] LPCSTR TransportDn,
[in] LPCSTR SourceDsaAddress,
[in] const PSCHEDULE pSchedule,
[in] DWORD Options
);
Parameter
[in] hDS
Enthält ein Verzeichnisdiensthandle, das von der DSBind - oder DSBindWithCred-Funktion abgerufen wurde.
[in] NameContext
Die nullbeendende Zeichenfolge, die den distinguished Name (DN) des Zielnamenskontexts (Destination Naming Context, NC) angibt, für den das Replikat hinzugefügt werden soll. Der NC-Zieldatensatz muss lokal als Objekt vorhanden sein, instanziiert oder nicht, oder als Referenz-Phantom, z. B. als Phantom mit einer GUID.
[in] SourceDsaDn
Die null-endende Zeichenfolge, die den DN des NTDS-DSA-Objekts für den System-Agent des Quellverzeichnisses angibt. Dieser Parameter ist erforderlich, wenn OptionsDS_REPADD_ASYNCHRONOUS_REPLICA enthält. andernfalls wird er ignoriert.
[in] TransportDn
Die NULL-Zeichenfolge, die den DN des interSiteTransport-Objekts angibt, das den transport darstellt, der für die Kommunikation mit dem Quellserver verwendet wird. Dieser Parameter ist erforderlich, wenn OptionsDS_REPADD_INTERSITE_MESSAGING enthält. andernfalls wird er ignoriert.
[in] SourceDsaAddress
Die null-endende Zeichenfolge, die die transportspezifische Adresse des Quell-DSA angibt. Dieser Quellserver wird durch einen Zeichenfolgennamen und nicht durch seine UUID identifiziert. Ein für SourceDsaAddress geeigneter Zeichenfolgenname ist in der Regel ein DNS-Name, der auf einer GUID basiert, wobei der GUID-Teil des Namens die GUID des NTDS-DSA-Objekts für den Quellserver ist.
[in] pSchedule
Zeiger auf eine SCHEDULE-Struktur , die die Replikationszeitplandaten für die Replikationsquelle enthält. Dieser Parameter ist optional und kann NULL sein, wenn er nicht verwendet wird.
[in] Options
Übergibt zusätzliche Daten, die zum Verarbeiten der Anforderung verwendet werden sollen. Für diesen Parameter ist eine Kombination der folgenden Werte gültig.
DS_REPADD_ASYNCHRONOUS_OPERATION
Führt diesen Vorgang asynchron aus.
DS_REPADD_ASYNCHRONOUS_REPLICA
Repliziert den NC nicht. Speichern Sie stattdessen genügend Zustandsdaten, damit sie später repliziert werden können.
DS_REPADD_DISABLE_NOTIFICATION
Deaktiviert die benachrichtigungsbasierte Synchronisierung für den NC aus dieser Quelle. Es wird erwartet, dass es sich um einen temporären Zustand handelt. Verwenden Sie DS_REPADD_NEVER_NOTIFY , um die Synchronisierung dauerhaft zu deaktivieren.
DS_REPADD_DISABLE_PERIODIC
Deaktiviert die regelmäßige Synchronisierung für den NC aus dieser Quelle.
DS_REPADD_INITIAL
Synchronisiert den NC aus dieser Quelle, wenn die DSA gestartet wird.
DS_REPADD_INTERSITE_MESSAGING
Synchronisiert vom Quell-DSA mithilfe des IMS-Transports (Intersite Messaging Service), z. B. per SMTP, anstatt den nativen Verzeichnisdienst RPC zu verwenden.
DS_REPADD_NEVER_NOTIFY
Deaktiviert Änderungsbenachrichtigungen aus dieser Quelle. Wenn dieses Flag festgelegt ist, benachrichtigt die Quelle das Ziel nicht, wenn Änderungen auftreten. Dies wird für alle standortübergreifenden Replikationen empfohlen, die über WAN-Verbindungen erfolgen können.
Es wird erwartet, dass es sich um einen dauerhaften Zustand handelt; verwenden Sie DS_REPADD_DISABLE_NOTIFICATION , um Benachrichtigungen vorübergehend zu deaktivieren.
DS_REPADD_PERIODIC
Synchronisiert den NC aus dieser Quelle in regelmäßigen Abständen, wie in pSchedule definiert.
DS_REPADD_USE_COMPRESSION
Verwendet die Komprimierung bei der Replikation. Dadurch wird Netzwerkbandbreite auf Kosten des CPU-Mehraufwands sowohl auf dem Quell- als auch auf dem Zielserver eingespart.
DS_REPADD_WRITEABLE
Erstellt ein beschreibbares Replikat. Andernfalls ist das Replikat schreibgeschützt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein.
Hinweise
Hinweis
Der ntdsapi.h-Header definiert DsReplicaAdd als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
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 |