Global Variable

kSecMatchItemList

A key whose value indicates a list of items to search.

Declaration

let kSecMatchItemList: CFString

Discussion

To provide your own set of items to be filtered by a search query rather than searching the keychain, specify this search key in a call to the SecItemCopyMatching(_:_:) function with a value that consists of an object of type CFArray where the array contains either SecKeychainItem, SecKey, SecCertificate, SecIdentity, or CFData items. The objects in the provided array must all be of the same type.

To convert from persistent item references to normal item references, specify this search key in a call to the SecItemCopyMatching(_:_:) function with a value of type CFArray where the array contains one or more CFData elements (the persistent references), and a return-type key of kSecReturnRef whose value is kCFBooleanTrue.

To delete an item identified by a transient reference, specify the kSecMatchItemList search key in a call to the SecItemDelete(_:) function with a reference returned by using the kSecReturnRef return type key in a previous call to the SecItemCopyMatching(_:_:) or SecItemAdd(_:_:) functions.

To delete an item identified by a persistent reference, specify the kSecMatchItemList search key in a call to the SecItemDelete(_:) function with a persistent reference returned by using the kSecReturnPersistentRef return type key to the SecItemCopyMatching(_:_:) or SecItemAdd(_:_:) functions.

See Also

Item Search Matching Keys

let kSecMatchPolicy: CFString

A key whose value indicates a policy with which a matching certificate or identity must verify.

let kSecMatchSearchList: CFString

A key whose value indicates a list of items to search.

let kSecMatchIssuers: CFString

A key whose value is a string to match against a certificate or identity's issuers.

let kSecMatchEmailAddressIfPresent: CFString

A key whose value is a string to match against a certificate or identity's email address.

let kSecMatchSubjectContains: CFString

A key whose value is a string to look for in a certificate or identity's subject.

let kSecMatchSubjectStartsWith: CFString

A key whose value is a string to match against the beginning of a certificate or identity's subject.

let kSecMatchSubjectEndsWith: CFString

A key whose value is a string to match against the end of a certificate or identity's subject.

let kSecMatchSubjectWholeString: CFString

A key whose value is a string to exactly match a certificate or identity's subject.

let kSecMatchCaseInsensitive: CFString

A key whose value is a Boolean indicating whether case-insensitive matching is performed.

let kSecMatchDiacriticInsensitive: CFString

A key whose value is a Boolean indicating whether diacritic-insensitive matching is performed.

let kSecMatchWidthInsensitive: CFString

A key whose value is a Boolean indicating whether width-insensitive matching is performed.

let kSecMatchTrustedOnly: CFString

A key whose value is a Boolean indicating whether untrusted certificates should be returned.

let kSecMatchValidOnDate: CFString

A key whose value indicates the validity date.

let kSecMatchLimit: CFString

A key whose value indicates the match limit.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software