DsBindA-Funktion (ntdsapi.h)
Die DsBind--Funktion wird an einen Domänencontroller gebunden.DsBind- verwendet die Standardprozessanmeldeinformationen zum Binden an den Domänencontroller. 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
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Domänencontrollers enthält, an den eine Bindung hergestellt werden soll. Dieser Name kann der Name des Domänencontrollers oder der vollqualifizierte DNS-Name des Domänencontrollers sein. Beide Namenstypen können optional zwei umgekehrte Schrägstriche vorangestellt werden. Alle folgenden Beispiele stellen richtig formatierte Domänencontrollernamen dar:
- "FAB-DC-01"
- "\\FAB-DC-01"
- "FAB-DC-01.fabrikam.com"
- "\\FAB-DC-01.fabrikam.com"
[in, optional] DnsDomainName
Zeiger auf eine mit Null beendete Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, an die eine Bindung hergestellt 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 ein Windows- oder RPC-Fehlercode andernfalls erfolgreich war. Im Folgenden finden Sie die am häufigsten verwendeten Fehlercodes.
Bemerkungen
Das Verhalten der DsBind--Funktion wird durch den Inhalt der parameter DomainControllerName und DnsDomainName bestimmt. In der folgenden Liste wird das Verhalten dieser Funktion basierend auf dem Inhalt dieser Parameter beschrieben.
| DomainControllerName- | DnsDomainName- | Beschreibung |
|---|---|---|
| NULL- | NULL- | DsBind versucht, eine Bindung an einen globalen Katalogserver in der Gesamtstruktur des lokalen Computers durchzuführen. |
| (Wert) | NULL- | DsBind- versucht, eine Bindung an den Domänencontroller durchzuführen, der durch den parameter DomainControllerName angegeben wird. |
| NULL- | (Wert) | DsBind- versucht, eine Bindung an einen beliebigen Domänencontroller in der durch DnsDomainName Parameter angegebenen Domäne durchzuführen. |
| (Wert)) | (Wert) | Der parameter DomainControllerName hat Vorrang. DsBind- versucht, eine Bindung an den Domänencontroller durchzuführen, der durch den parameter DomainControllerName angegeben wird. |
Anmerkung
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 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 |