ldap_compare_extW-Funktion (winldap.h)

2024-11-20

Verwenden Sie die ldap_compare_ext-Funktion, um zu bestimmen, ob ein Attribut für einen bestimmten Eintrag einen bekannten Wert enthält.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_compare_extW(
  [in]  LDAP          *ld,
  [in]  const PWSTR   dn,
  [in]  const PWSTR   Attr,
  [in]  const PWSTR   Value,
  [in]  berval        *Data,
  [in]  PLDAPControlW *ServerControls,
  [in]  PLDAPControlW *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den unterschiedenen Namen des zu vergleichenden Eintrags enthält.

[in] Attr

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die das zu vergleichende Attribut enthält.

[in] Value

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Zeichenfolgen-Attributwert enthält, der mit dem Attributwert verglichen werden soll.

[in] Data

Der berval Attributwert, der mit dem Attributwert verglichen werden soll.

[in] ServerControls

Wahlfrei. Eine Liste der LDAP-Serversteuerelemente. Dieser Parameter sollte auf NULL- festgelegt werden, wenn er nicht verwendet wird.

[in] ClientControls

Wahlfrei. Eine Liste der Clientsteuerelemente. Dieser Parameter sollte auf NULL- festgelegt werden, wenn er nicht verwendet wird.

[out] MessageNumber

Die Nachrichten-ID für den Vergleichsvorgang.

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

Die ldap_compare_ext-Funktion initiiert einen asynchronen Vergleichsvorgang, wobei der Wert eines Attributs mit einem bekannten Wert verglichen wird. Die Parameter und Effekte von ldap_compare_ext subsumieren diejenigen von ldap_compare. Die erweiterte Routine enthält zusätzliche Parameter zur Unterstützung von Client- und Serversteuerelementen, zum Vergleich von Binärwerten und zur Threadsicherheit.

Verwenden Sie den parameter Value, um Zeichenfolgenwerte zu vergleichen, oder verwenden Sie den Parameter Data zum Vergleichen unformatierter Binärdaten. Legen Sie den nicht verwendeten Parameter auf NULL-fest. Wenn kein Parameter NULL-ist, verwendet der Vergleichsvorgang den Wert im Data-Parameter.

Bei erfolgreicher Ausführung übergibt ldap_compare_ext die Nachrichten-ID für den Vorgang im MessageNumber Parameter zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vergleichs zu erhalten. Damit die Funktion das Vergleichsergebnis direkt zurückgibt, verwenden Sie die synchrone erweiterte Vergleichsfunktion ldap_compare_ext_s.

Multithreading: Aufrufe von ldap_compare_ext sind threadsicher.

Anmerkung

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