ldap_compare_ext-Funktion (winldap.h)

2023-08-27

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

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_compare_ext(
  [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-endende Zeichenfolge, die den distinguished Name des zu vergleichenden Eintrags enthält.

[in] Attr

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

[in] Value

Ein Zeiger auf eine NULL-endende 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

Optional. Eine Liste der LDAP-Serversteuerelemente. 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 funktion ldap_compare_ext 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 enthält zusätzliche Parameter, um Client- und Serversteuerelemente, den Vergleich von Binärwerten und die Threadsicherheit zu unterstützen.

Verwenden Sie den Value-Parameter zum Vergleichen von Zeichenfolgenwerten, oder verwenden Sie den Parameter Data zum Vergleichen von Binären Rohdaten. Legen Sie den nicht verwendeten Parameter auf NULL fest. Wenn keiner der 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.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	winldap.h
Bibliothek	Wldap32.lib
DLL	Wldap32.dll