PingDirectory

Search reference criteria

Use search reference criteria when matching search result references, which provide information about other servers or different portions of the DIT in which the client can continue the search. They contain a set of referral URLs and an optional set of controls.

Simple search reference criteria

Simple search reference criteria objects provide support for matching search result references based on the following properties.

Property Description

request-criteria

An optional reference to request criteria that is expected to match the search request for this reference criteria to match.

all-included-reference-control

An optional set of OIDs of controls that must be included with the search result reference to match this criteria. If multiple OIDs are specified, then the reference must have all of those controls.

any-included-reference-control

An optional set of OIDs of controls that must be included with the search result reference to match this criteria. If multiple OIDs are specified, then the reference must have at least one of those controls.

not-all-included-reference-control

An optional set of OIDs of controls that should not be included with the search result reference to match this criteria. If multiple OIDs are specified, then the reference can optionally have one or more of those controls as long as it does not have all of them.

none-included-reference-control

An optional set of OIDs of controls that should not be included with the search result reference to match this criteria. If multiple OIDs are specified, then the reference must not have any of those controls.

Aggregate search reference criteria

Use aggregate search reference criteria to create a single search reference criteria that combines multiple other search reference criteria objects.

It offers the following properties.

Property Description

all-included-search-reference-criteria

An optional set of the search reference criteria objects that must all match the reference for this aggregate criteria to match.

any-included-search-reference-criteria

An optional set of the search reference criteria objects in which at least one of those criteria objects must match the reference for this aggregate criteria to match.

not-all-included-search-reference-criteria

An optional set of the search reference criteria objects in which at least one of those criteria objects must not match the reference for this aggregate criteria to match.

none-included-search-reference-criteria

An optional set of the search reference criteria objects in which none of those objects can match the reference for this aggregate criteria to match.