ldap_set_option-Funktion (winldap.h)
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 |