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 |