Search Control

The FN_search_control_t object encapsulates the different options that the application can specify in controlling the scope and the return values of the extended search operation, fn_attr_ext_search() .

These options are:

• Scope of search. This determines which contexts and objects will be searched. The default is FN_SEARCH_ONE_CONTEXT.

Table 2-5 Different Scopes for Searching

Scope	Meaning
FN_SEARCH_NAMED_OBJECT	Search just the given named object.
FN_SEARCH_ONE_CONTEXT	Search just the given context.
FN_SEARCH_SUBTREE	Search given context and all its subcontexts.
FN_SEARCH_CONSTRAINED_SUBTREE	Search given context and its subcontexts as constrained by the context-specific policy in place at the named context.

• fFollow links during search. This determines whether links encountered during the search will be followed. The initial resolution phase of the operation (the resolution up to the target context) always follow links. This option controls the following of links after reaching the target context.

  The default is to not follow links.

• Maximum names returned. This specifies the maximum number of names to be returned before terminating the search. A value of 0 indicates that the search is terminated only when all the context and objects specified by the scope have been searched.

  The default is to return all named objects found.

• Return reference. This determines whether the reference of the object is returned.

  The default is to not return the reference.

• Return attributes. This determines which attributes associated with the named object, if any, are returned.

  The default is to not return any attributes.