ldap_set_option-Funktion (winldap.h)

Artikel
08/27/2023

Die ldap_set_option-Funktion legt Optionen für Verbindungsblöcke fest. Weitere Informationen zu Strukturen finden Sie unter Datenstrukturen.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_set_option(
  [in] LDAP       *ld,
  [in] int        option,
  [in] const void *invalue
);

Parameter

[in] ld

Das Sitzungshandle.

[in] option

Der Name des Optionssatzes.

[in] invalue

Ein Zeiger auf den Wert, den die Option geben soll. Der tatsächliche Typ dieses Parameters hängt von der Einstellung des Optionsparameters ab. Die Konstanten LDAP_OPT_ON und LDAP_OPT_OFF können für Optionen mit Ein- oder Ausschalteinstellungen angegeben werden.

Rückgabewert

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

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

Hinweise

Rufen Sie ldap_set_option auf, um auf die LDAP-Struktur zuzugreifen, die eine LDAP-Sitzung darstellt. Versuchen Sie nicht, die LDAP-Datenstruktur direkt zu ändern.

Weitere Informationen und eine Beschreibung der optionalen Einstellungen, die für eine LDAP-Sitzung gelten, finden Sie unter Sitzungsoptionen. Weitere Informationen zu Flags finden Sie unter DsGetDcName.

Es ist jetzt möglich, ihren gesamten LDAP-Datenverkehr zu und von einem Windows-LDAP-Server mithilfe des Kerberos-Authentifizierungsprotokolls digital zu signieren oder zu verschlüsseln. Dieses neue Feature bietet Integrität und Vertraulichkeit, die für einige Anwendungen erforderlich ist. Beachten Sie, dass die Verwendung von Secure Sockets Layer (SSL) dieselben Vorteile bietet, aber umfangreiche Zertifikatregistrierungen für den Server und manchmal auch für den Client erfordert.

Um das Signieren und Versiegeln zu aktivieren, müssen Sie eine der folgenden Optionen aktivieren, bevor Sie ldap_bind_s mit LDAP_AUTH_NEGOTIATE für die Bindmethode aufrufen.

#define LDAP_OPT_SIGN      0x95
#define LDAP_OPT_ENCRYPT   0x96

Um das Signieren und Verschließen zu deaktivieren, schließen Sie die Verbindung, indem Sie ldap_unbind() auf dem Verbindungshandle aufrufen.

Multithreading: Aufrufe an ldap_set_option sind unsicher, da es sich auf die gesamte Verbindung auswirkt. Gehen Sie mit Vorsicht vor, wenn Threads Verbindungen gemeinsam nutzen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	winldap.h
Bibliothek	Wldap32.lib
DLL	Wldap32.dll