DsBindToISTGA-Funktion (ntdsapi.h)

Die DsBindToISTG-Funktion wird an den Computer gebunden, der die Istg-Rolle (Inter-Site Topology Generator) in der Domäne des lokalen Computers enthält.

Syntax

NTDSAPI_POSTXP DWORD DsBindToISTGA(
  [in, optional] LPCSTR SiteName,
  [out]          HANDLE *phDS
);

Parameter

[in, optional] SiteName

Zeiger auf eine NULL-endende Zeichenfolge, die den bei der Bindung verwendeten Websitenamen enthält. Wenn dieser Parameter NULL ist, wird der Standort des nächstgelegenen Domänencontrollers verwendet.

[out] phDS

Adresse eines HANDLE-Werts , der das Bindungshandle empfängt. Um dieses Handle zu schließen, rufen Sie DsUnBind auf.

Rückgabewert

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Win32- oder RPC-Fehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsBindToISTG 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

Weitere Informationen

Domänencontroller- und Replikationsverwaltungsfunktionen

DsUnBind