ldap_parse_sort_control-Funktion (winldap.h)

2024-03-13

Die ldap_parse_sort_control-Funktion analysiert das vom Server zurückgegebene Sortiersteuerelement.

Syntax

WINLDAPAPI ULONG LDAPAPI ldap_parse_sort_control(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlA *Control,
  [out] ULONG         *Result,
  [out] PCHAR         *Attribute
);

Parameter

[in] ExternalHandle

Das Sitzungshandle.

[in] Control

Das Vom Server zurückgegebene Steuerelement, das von einem Aufruf von ldap_parse_result abgerufen wurde.

[out] Result

Der Ergebniscode.

[out] Attribute

Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Attributs enthält, das zum Fehlschlagen des Vorgangs führte.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert LDAP_SUCCESS.

Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Rückgabewerte .

Hinweise

Wenn der Server die Ergebnisse zurückgibt, gibt er ein Steuerelement in der SearchResultDone-Nachricht zurück. Rufen Sie ldap_parse_sort_control auf, um dieses Sortiersteuerelement zu analysieren.

Wenn beim Sortiervorgang ein Fehler aufgetreten ist, gibt der Server möglicherweise den Namen des Attributs zurück, das den Fehler verursacht hat. Rufen Sie in diesem Fall ldap_memfree auf, um den Attributwert frei zu geben.

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

Freigeben über