ldap_escape_filter_elementA-Funktion (winldap.h)

Artikel
03/06/2024

Die ldap_escape_filter_element-Funktion konvertiert ein Filterelement in eine NULL-endende Zeichenfolge, die sicher in einem Suchfilter übergeben werden kann.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_escape_filter_elementA(
  [in]  PCHAR sourceFilterElement,
  [in]  ULONG sourceLength,
  [out] PCHAR destFilterElement,
  [in]  ULONG destLength
);

Parameter

[in] sourceFilterElement

Ein Zeiger auf eine NULL-endende Zeichenfolge, die das zu konvertierende Filterelement enthält.

[in] sourceLength

Die Länge des Quellfilterelements in Bytes.

[out] destFilterElement

Ein Zeiger auf eine NULL-endende Zeichenfolge.

[in] destLength

Die Länge des destFilterElement-Puffers in Bytes.

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 Zurückgeben von Werten .

Hinweise

Mit der funktion ldap_escape_filter_element können Sie binäre Rohdaten in Suchfiltern verwenden. Mit dieser Funktion können Sie beispielsweise ein Zertifikat oder ein JPEG-Bild als übereinstimmende Attribut angeben.

Rufen Sie ldap_escape_filter_element auf, wobei der SourceFilterElement-Parameter auf Rohdaten verweist, und sourceLength entsprechend auf die Länge der Daten festgelegt ist. Wenn der destFilterElement-ParameterNULL ist, ist der Rückgabewert die länge, die für den Ausgabepuffer erforderlich ist. Wenn destFilterElement nicht NULL ist, kopiert die Funktion die Quelle in den Zielpuffer und stellt sicher, dass sie ein sicheres Format aufweist. Fügen Sie dann den Zielpuffer nach dem Filterelement "attributetype=" in Ihren Suchfilter ein.

Hinweis Rufen Sie ldap_escape_filter_element nicht für Attributwerte auf, bei denen es sich um Zeichenfolgen handelt, da die Laufzeit keine Konvertierung aus dem UTF-8-Format ausführt. Verwenden Sie diese Funktion nur für Attributelemente, bei denen es sich um binäre Rohdaten handelt.

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

Siehe auch

Funktionen

Rückgabewerte

Freigeben über