ldap_sasl_bindW-Funktion (winldap.h)

2024-11-20

Die ldap_sasl_bind ist eine asynchrone Funktion, die einen Client mit SASL auf dem LDAP-Server authentifiziert.

Syntax

WINLDAPAPI INT LDAPAPI ldap_sasl_bindW(
  [in]  LDAP          *ExternalHandle,
  [in]  const PWSTR   DistName,
  [in]  const PWSTR   AuthMechanism,
  [in]  const BERVAL  *cred,
  [in]  PLDAPControlW *ServerCtrls,
  [in]  PLDAPControlW *ClientCtrls,
  [out] int           *MessageNumber
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] DistName

Der distinguished name of the entry used to bind.

[in] AuthMechanism

Gibt die zu verwendende Authentifizierungsmethode an.

[in] cred

Die für die Authentifizierung zu verwendenden Anmeldeinformationen. Beliebige Anmeldeinformationen können mithilfe dieses Parameters übergeben werden. Das Format und der Inhalt der Anmeldeinformationen hängen vom Wert des übergebenen Arguments AuthMechanism ab. Weitere Informationen finden Sie in den Hinweisen.

[in] ServerCtrls

Eine Liste der LDAP-Serversteuerelemente.

[in] ClientCtrls

Eine Liste der LDAP-Clientsteuerelemente.

[out] MessageNumber

Die Nachrichten-ID für den Bindungsvorgang.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.

Wenn die Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte.

Bemerkungen

Die ldap_sasl_bind Routine bindet mithilfe des SASL-Protokolls (Simple Authentication and Security Layer) an einen LDAP-Server. Der Bindungsvorgang identifiziert einen Client an den Verzeichnisserver, indem er einen distinguishierten Namen und einen bestimmten Typ von Authentifizierungsanmeldeinformationen bereitstellt. Die verwendete Authentifizierungsmethode bestimmt den bestimmten Typ von Anmeldeinformationen und wird durch das AuthMechanism Argument angegeben. Dies wird als Zeichenfolge in Form von "GSSAPI", "GSS-SPNEGO", "DIGEST-MD5" usw. übergeben. Diese Funktion kann verwendet werden, um beliebige Anmeldeinformationen an den Server zu übergeben, sodass die Anwendung bereit sein muss, die vom Server zurückgesendete Antwort zu interpretieren.

Hinweis Der Microsoft LDAP-Client verwendet für jedes Bindungsantwort-Roundtrip einen Standardtimeoutwert von 120 Sekunden (2 Minuten). Dieser Timeoutwert kann mithilfe der Option LDAP_OPT_TIMELIMIT Sitzung geändert werden. Andere Vorgänge verfügen nicht über ein Timeout, es sei denn, es wird ldap_set_optionverwendet.

Anmerkung

Der winldap.h-Header definiert ldap_sasl_bind 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-	winldap.h
Library	Wldap32.lib
DLL-	Wldap32.dll