DsBindA-Funktion (ntdsapi.h)

Die DsBind-Funktion bindet an einen Domänencontroller. DsBind verwendet die Standardanmeldeinformationen für den Prozess, um an den Domänencontroller zu binden. Verwenden Sie die DsBindWithCred-Funktion , um alternative Anmeldeinformationen anzugeben.

Syntax

NTDSAPI DWORD DsBindA(
  [in, optional] LPCSTR DomainControllerName,
  [in, optional] LPCSTR DnsDomainName,
  [out]          HANDLE *phDS
);

Parameter

[in, optional] DomainControllerName

Zeiger auf eine null-beendete Zeichenfolge, die den Namen des Domänencontrollers enthält, an den gebunden werden soll. Dieser Name kann der Name des Domänencontrollers oder der vollqualifizierte DNS-Name des Domänencontrollers sein. Jedem Namentyp können optional zwei umgekehrte Schrägstriche vorangestellt werden. Alle folgenden Beispiele stellen ordnungsgemäß formatierte Domänencontrollernamen dar:

  • "FAB-DC-01"
  • "\\FAB-DC-01"
  • "FAB-DC-01.fabrikam.com"
  • "\\FAB-DC-01.fabrikam.com"
Dieser Parameter kann NULL sein. Weitere Informationen finden Sie in den Hinweisen.

[in, optional] DnsDomainName

Zeiger auf eine NULL-Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, an die gebunden werden soll. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie in den Hinweisen.

[out] phDS

Adresse eines HANDLE-Werts , der das Bindungshandle empfängt. Um dieses Handle zu schließen, übergeben Sie es an die DsUnBind-Funktion .

Rückgabewert

Gibt ERROR_SUCCESS zurück, wenn erfolgreich oder ein Windows- oder RPC-Fehlercode andernfalls. Im Folgenden finden Sie die häufigsten Fehlercodes.

Hinweise

Das Verhalten der DsBind-Funktion wird durch den Inhalt der Parameter DomainControllerName und DnsDomainName bestimmt. Die folgende Liste beschreibt das Verhalten dieser Funktion basierend auf dem Inhalt dieser Parameter.

DomainControllerName DnsDomainName BESCHREIBUNG
NULL NULL DsBind versucht, eine Bindung an einen globalen Katalogserver in der Gesamtstruktur des lokalen Computers durchzuführen.
(value) NULL DsBind versucht, eine Bindung an den durch den Parameter DomainControllerName angegebenen Domänencontroller zu erstellen.
NULL (value) DsBind versucht, eine Bindung an einen beliebigen Domänencontroller in der durch den Parameter DnsDomainName angegebenen Domäne durchzuführen.
(Wert

)
(value) Der Parameter DomainControllerName hat Vorrang. DsBind versucht, eine Bindung an den durch den Parameter DomainControllerName angegebenen Domänencontroller zu erstellen.
 

Hinweis

Der ntdsapi.h-Header definiert DsBind 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 nicht codierungsneutralem Code 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

DOMAIN_CONTROLLER_INFO

Domänencontroller und Replikationsverwaltungsfunktionen

DsBindWithCred

Dsgetdcname

DsUnBind