Global Variable

kSecMatchItemList

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

Declaration

const CFStringRef kSecMatchItemList;

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 CFArrayRef where the array contains either SecKeychainItemRef, SecKeyRef, SecCertificateRef, SecIdentityRef, or CFDataRef 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 CFArrayRef where the array contains one or more CFDataRef 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

kSecMatchPolicy

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

kSecMatchSearchList

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

kSecMatchIssuers

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

kSecMatchEmailAddressIfPresent

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

kSecMatchSubjectContains

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

kSecMatchSubjectStartsWith

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

kSecMatchSubjectEndsWith

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

kSecMatchSubjectWholeString

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

kSecMatchCaseInsensitive

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

kSecMatchDiacriticInsensitive

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

kSecMatchWidthInsensitive

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

kSecMatchTrustedOnly

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

kSecMatchValidOnDate

A key whose value indicates the validity date.

kSecMatchLimit

A key whose value indicates the match limit.