ldap_extended_operationA-Funktion (winldap.h)

2023-08-27

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

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_extended_operationA(
  [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-beendete 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 von LDAP-Serversteuerelementen. Legen Sie diesen Parameter auf NULL fest, falls er nicht verwendet wird.

[in] ClientControls

Optional. Eine Liste der Clientsteuerelemente. Legen Sie diesen Parameter auf NULL fest, falls 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 ldap_extended_operation-Funktion 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 Natur der Anforderung muss der Client ldap_close_extended_op aufrufen, um die Anforderung zu beenden.

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

Siehe auch

Funktionen

Rückgabewerte

ldap_abandon

ldap_close_extended_op

ldap_result

Freigeben über