ldap_parse_sort_controlW function (winldap.h)
The ldap_parse_sort_control function parses the sort control returned by the server.
Syntax
WINLDAPAPI ULONG LDAPAPI ldap_parse_sort_controlW(
[in] PLDAP ExternalHandle,
[in] PLDAPControlW *Control,
[out] ULONG *Result,
[out] PWCHAR *Attribute
);
Parameters
[in] ExternalHandle
The session handle.
[in] Control
The control returned from the server, as obtained from a call to ldap_parse_result.
[out] Result
The result code.
[out] Attribute
A pointer to a null-terminated string that contains the name of the attribute that caused the operation to fail.
Return value
If the function succeeds, the return value is LDAP_SUCCESS.
If the function fails, it returns an error code. See Return Values for more information.
Remarks
When the server returns the results, it returns a control in the SearchResultDone message. Call ldap_parse_sort_control to parse this sort control.
If the sort operation failed, the server may return the name of the attribute that caused the failure. In this case, call ldap_memfree to free the attribute value
Note
The winldap.h header defines ldap_parse_sort_control as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista |
Minimum supported server | Windows Server 2008 |
Target Platform | Windows |
Header | winldap.h |
Library | Wldap32.lib |
DLL | Wldap32.dll |