Function

SecKeychainSetSearchList

Specifies the list of keychains to use in the default keychain search list.

Declaration

OSStatus SecKeychainSetSearchList(CFArrayRef searchList);

Parameters

searchList

An array of keychain references (of type SecKeychainRef) specifying the list of keychains to use in the default keychain search list. Passing an empty array clears the search list.

Return Value

Discussion

The default keychain search list is used by several functions; see for example SecKeychainSearchCreateFromAttributes, SecKeychainFindInternetPassword, or SecKeychainFindGenericPassword. To obtain the current default keychain search list, use the SecKeychainCopySearchList function.

The default keychain search list is displayed as the keychain list in the Keychain Access utility. If you use SecKeychainSetSearchList to change the keychain search list, the list displayed in Keychain Access changes accordingly.

See Also

Search

SecKeychainCopySearchList

Retrieves a keychain search list.

SecKeychainSearchRef

An opaque type that contains information about a keychain search.

SecKeychainSearchGetTypeID

Returns the unique identifier of the opaque type to which a keychain search object belongs.

Deprecated
SecKeychainSearchCreateFromAttributes

Creates a search object matching a list of zero or more attributes.

Deprecated
SecKeychainSearchCopyNext

Finds the next keychain item matching the given search criteria.

Deprecated