ldap_create_sort_control函式 (winldap.h)
ldap_create_sort_control函式可用來將排序索引鍵清單格式化為搜尋控件。 支援控件可透過LDAP 3有效，但是否支援排序控件是否相依於特定伺服器。
語法
WINLDAPAPI ULONG LDAPAPI ldap_create_sort_control(
[in] PLDAP ExternalHandle,
[in] PLDAPSortKeyA *SortKeys,
[in] UCHAR IsCritical,
[out] PLDAPControlA *Control
);
參數
[in] ExternalHandle
會話句柄。
[in] SortKeys
LDAPSortKey 結構的陣列指標。 陣列中的每個結構都會指定要做為排序索引鍵的屬性名稱、該索引鍵的比對規則，以及排序順序是遞增還是遞減。
[in] IsCritical
通知伺服器此控制項是否對搜尋很重要。 0 ==> FALSE，！0 ==> TRUE。
[out] Control
新建立控件的指標。
傳回值
此函式會傳回 WINLDAPAPI ULONG LDAPAPI。
備註
ldap_create_sort_control 函式會建立基本排序控件。 當LDAP用戶端的功能有限且無法排序結果時，這類控件很有用，但仍需要排序結果。
排序控件可讓伺服器傳回結果碼，以排序與搜尋作業傳回的結果碼無關的結果碼。
此函式會建立 控制項 - 它不會驗證伺服器是否支援它，因此，如果伺服器不支援控件，則不會傳回LDAP_UNAVAILABLE_CRIT_EXTENSION。 不過，它可以傳回其他標準LDAP傳回值，例如LDAP_NO_MEMORY或LDAP_PARAM_ERROR。
若要在不再需要控件時釋放控件，請呼叫 ldap_control_free。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | winldap.h |
| 程式庫 | Wldap32.lib |
| Dll | Wldap32.dll |