ldap_extended_operation-Funktion (winldap.h)

2023-08-27

Mit der funktion ldap_extended_operation können Sie erweiterte LDAP-Vorgänge an den Server übergeben.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_extended_operation(
  [in]  LDAP          *ld,
  [in]  const PSTR    Oid,
  [in]  berval        *Data,
  [in]  PLDAPControlA *ServerControls,
  [in]  PLDAPControlA *ClientControls,
  [out] ULONG         *MessageNumber
);

Parameter

[in] ld

Das Sitzungshandle.

[in] Oid

Ein Zeiger auf eine NULL-endende Zeichenfolge, die die gepunktete Objektbezeichnertextzeichenfolge enthält, die die Anforderung benennt.

[in] Data

Die für den Vorgang erforderlichen beliebigen Daten. Bei NULL werden keine Daten an den Server gesendet.

[in] ServerControls

Optional. Eine Liste der LDAP-Serversteuerelemente. Legen Sie diesen Parameter auf NULL fest, wenn er nicht verwendet wird.

[in] ClientControls

Optional. Eine Liste der Clientsteuerelemente. Legen Sie diesen Parameter auf NULL fest, wenn er nicht verwendet wird.

[out] MessageNumber

Die Nachrichten-ID für die Anforderung.

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_extended_operation ermöglicht es einem Client, eine erweiterte Anforderung (kostenlos für alle) an einen LDAP 3-Server (oder höher) zu senden. Die Funktionalität ist geöffnet, und die Clientanforderung kann für jeden Vorgang verwendet werden.

Als asynchrone Funktion gibt ldap_extended_operation eine Nachrichten-ID für den Vorgang zurück. Rufen Sie ldap_result mit der Nachrichten-ID auf, um das Ergebnis des Vorgangs zu erhalten. Um einen asynchronen Vorgang abzubrechen, rufen Sie ldap_abandon auf.

Aufgrund der offenen Art der Anforderung muss der Client ldap_close_extended_op aufrufen, um die Anforderung zu beenden.

Multithreading: Die funktion ldap_extended_operation ist 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

Siehe auch

Funktionen

Rückgabewerte

ldap_abandon

ldap_close_extended_op

ldap_result

Freigeben über