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"
[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 |