ldap_check_filterA-Funktion (winldap.h)

2024-11-20

Die funktion ldap_check_filter wird verwendet, um die Filtersyntax zu überprüfen.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_check_filterA(
  [in] LDAP *ld,
  [in] PSTR SearchFilter
);

Parameter

[in] ld

Das Sitzungshandle.

[in] SearchFilter

Ein Zeiger auf eine breite, mit Null beendete Zeichenfolge, die den Namen des zu überprüfenden Filters enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird LDAP_SUCCESS zurückgegeben.

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

Bemerkungen

Verwenden Sie ldap_check_filter, um die Syntax eines Suchfilters zu überprüfen, bevor Sie eine Suche initiieren. Diese Syntaxüberprüfung führt keine vollständige Überprüfung der Suchfiltersyntax anhand von RFC 2254-Regeln durch. Stattdessen wird überprüft, ob der Filter die mindest syntaktischen Anforderungen für die Codierung erfüllt, die von den Suchfilter-Codierungsroutinen von wldap32 benötigt werden. Daher kann ein Suchfilter einen ldap_check_filter Vorgang übergeben und von wldap32 codiert werden, aber der Server erkennt möglicherweise weiterhin eine RFC 2254-Complianceverletzung und lehnt den Suchfilter ab.

Anmerkung

Der winldap.h-Header definiert ldap_check_filter 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

Siehe auch

Funktionen

Rückgabewerte

ldap_search

Freigeben über