DsReplicaAddA-Funktion (ntdsapi.h)

Artikel
02/29/2024

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