DsBindWithCredA-Funktion (ntdsapi.h)

Artikel
02/29/2024

Die DsBindWithCred-Funktion bindet mit den angegebenen Anmeldeinformationen an einen Domänencontroller.

Syntax

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

Parameter

[in, optional] DomainControllerName

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollqualifizierten DNS-Namen der zu bindenden Domäne enthält. Weitere Informationen zu diesem Parameter finden Sie in der DomainControllerName-Beschreibung im Thema DsBind .

[in, optional] DnsDomainName

Zeiger auf eine NULL-Zeichenfolge, die den vollqualifizierten DNS-Namen der Domäne enthält, an die gebunden werden soll. Weitere Informationen zu diesem Parameter finden Sie in der Beschreibung DnsDomainName im Thema DsBind .

Dieser Parameter ist erforderlich, um eine Kerberos-Authentifizierung zu schützen.

[in, optional] AuthIdentity

Enthält einen RPC_AUTH_IDENTITY_HANDLE Wert, der die Anmeldeinformationen darstellt, die für die Bindung verwendet werden sollen. The

Die DsMakePasswordCredentials-Funktion wird verwendet, um diesen Wert abzurufen. Wenn dieser Parameter NULL ist, werden die Anmeldeinformationen des aufrufenden Threads verwendet.

DsUnBind muss aufgerufen werden, bevor dieses Handle mit der DsFreePasswordCredentials-Funktion freigegeben wird.

[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

Hinweis

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