ldap_compare_extA-Funktion (winldap.h)

2024-03-04

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_extA(
  [in]  LDAP          *ld,
  [in]  const PSTR    dn,
  [in]  const PSTR    Attr,
  [in]  const PSTR    Value,
  [in]  berval        *Data,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] dn

Ein Zeiger auf eine null-beendete Zeichenfolge, die den distinguished Name des zu vergleichenden Eintrags enthält.

[in] Attr

Ein Zeiger auf eine NULL-Zeichenfolge, die das zu vergleichende Attribut enthält.

[in] Value

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

[in] Data

Der wert des berval-Attributs , der mit dem Attributwert verglichen werden soll.

[in] ServerControls

Optional. Eine Liste von LDAP-Serversteuerelementen. Dieser Parameter sollte auf NULL festgelegt werden, wenn er nicht verwendet wird.

[in] ClientControls

Optional. 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 .

Hinweise

Die ldap_compare_ext-Funktion initiiert einen asynchronen Vergleichsvorgang, wobei der Wert eines Attributs mit einem bekannten Wert verglichen wird. Die Parameter und Auswirkungen von ldap_compare_ext subsumieren diejenigen von ldap_compare. Die erweiterte Routine umfasst zusätzliche Parameter, um Client- und Serversteuerelemente, den Vergleich von Binärwerten und die Threadsicherheit zu unterstützen.

Verwenden Sie den Wert-Parameter zum Vergleichen von Zeichenfolgenwerten oder den Data-Parameter zum Vergleichen von rohen Binärdaten. Legen Sie den nicht verwendeten Parameter auf NULL fest. Wenn keiner der Beiden 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 abzurufen. Damit die Funktion das Vergleichsergebnis direkt zurückgibt, verwenden Sie die synchrone erweiterte Vergleichsfunktion ldap_compare_ext_s.

Multithreading: Aufrufe an ldap_compare_ext sind threadsicher.

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