DsReplicaAddA-Funktion (ntdsapi.h)
Die DsReplicaAdd-Funktion fügt einen Replikationsquellenverweis zu einem Zielbenennungskontext 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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] NameContext
Die mit Null beendete Zeichenfolge, die den distinguished Name (DN) des Zielbenennungskontexts (NC) angibt, für den das Replikat hinzugefügt werden soll. Der NC-Zieldatensatz muss lokal als Objekt vorhanden sein, instanziiert oder nicht, oder ein Referenz-Phantom, z. B. ein Phantom mit einer GUID.
[in] SourceDsaDn
Die mit Null beendete Zeichenfolge, die den DN des NTDS-DSA--Objekts für den Quellverzeichnissystem-Agent angibt. Dieser Parameter ist erforderlich, wenn OptionenDS_REPADD_ASYNCHRONOUS_REPLICAenthält; andernfalls wird sie ignoriert.
[in] TransportDn
Die mit Null beendete 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 OptionenDS_REPADD_INTERSITE_MESSAGINGenthält; andernfalls wird sie ignoriert.
[in] SourceDsaAddress
Die mit Null beendete Zeichenfolge, die die transportspezifische Adresse der DSA-Quelle angibt. Dieser Quellserver wird durch einen Zeichenfolgennamen und nicht durch seine UUID identifiziert. Ein Zeichenfolgenname, der für SourceDsaAddress- geeignet ist, ist in der Regel ein DNS-Name basierend auf einer GUID, 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 bei Verwendung NULL- werden.
[in] Options
Übergibt zusätzliche Daten, die zum Verarbeiten der Anforderung verwendet werden sollen. Dieser Parameter kann eine Kombination aus den folgenden Werten sein.
DS_REPADD_ASYNCHRONOUS_OPERATION
Führt diesen Vorgang asynchron aus.
DS_REPADD_ASYNCHRONOUS_REPLICA
Repliziert die NC nicht. Speichern Sie stattdessen genügend Zustandsdaten, sodass sie später repliziert werden können.
DS_REPADD_DISABLE_NOTIFICATION
Deaktiviert die Benachrichtigungsbasierte Synchronisierung für die NC von dieser Quelle. Dies 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 die NC von dieser Quelle.
DS_REPADD_INITIAL
Synchronisiert die NC aus dieser Quelle, wenn die DSA gestartet wird.
DS_REPADD_INTERSITE_MESSAGING
Synchronisiert von der DSA-Quelle mithilfe des IMS-Transports (Intersite Messaging Service), z. B. nach SMTP, anstatt den nativen Verzeichnisdienst RPC zu verwenden.
DS_REPADD_NEVER_NOTIFY
Deaktiviert Änderungsbenachrichtigungen von dieser Quelle. Wenn dieses Kennzeichen festgelegt ist, benachrichtigt die Quelle das Ziel nicht, wenn Änderungen vorgenommen werden. Dies wird für alle standortübergreifenden Replikationen empfohlen, die über WAN-Verbindungen auftreten können.
Dies 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 die NC aus dieser Quelle regelmäßig, wie in pScheduledefiniert.
DS_REPADD_USE_COMPRESSION
Verwendet komprimierung beim Replizieren. Dadurch wird die Netzwerkbandbreite auf Kosten des CPU-Aufwands sowohl auf den Quell- als auch auf den Zielservern gespart.
DS_REPADD_WRITEABLE
Erstellt ein schreibbares 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 eine der folgenden Sein:
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |