Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The LDAP_SERVER_SEARCH_HINTS_OID control is used with an LDAP search operation. This control supplies hints to the search operation on how to satisfy the search. When sending this control to the DC, the controlValue field is set to the BER encoding of the following ASN.1 structure.
-
SearchHintsRequestValue ::= SEQUENCE OF SEQUENCE{ hintId LDAPOID hintValue OCTET STRING }
where hintId is an OID that corresponds to a specific hint name, and hintValue is a value related to that hint. Each hint specifies an encoding for its value.
The following table specifies the hints that a DC MUST honor. A DC MAY honor other implementation-defined search hints. No other search hints are honored by DCs in applicable Windows Server releases.
-
Statistic name
OID (as specified by hintId)
Require Sort Index
1.2.840.113556.1.4.2207
Soft Size Limit
1.2.840.113556.1.4.2210
Multiple instances of the LDAP_SERVER_SEARCH_HINTS_OID control can be included with a single LDAP search operation. The hints are applied in the order in which the controls are encoded in the LDAP request; that is, a later hint can override an earlier hint, overriding both hintValue and control criticality. This behavior allows the application of different criticality to individual hints.
If the control is critical and an unrecognized search hint is specified, the DC returns the error unwillingToPerform / <unrestricted>. If the control is not critical, unrecognized hints are ignored.