SecItemDelete

Function SecItemDelete 

Source
pub unsafe extern "C-unwind" fn SecItemDelete(
    query: &CFDictionary,
) -> i32
Available on crate feature SecItem only.
Expand description

Delete zero or more items which match a search query.

Parameter query: A dictionary containing an item class specification and optional attributes for controlling the search. See the “Attribute Constants” and “Search Constants” sections for a description of currently defined search attributes.

Returns: A result code. See “Security Error Codes” (SecBase.h).

Attributes defining a search are specified by adding key/value pairs to the query dictionary.

By default, this function deletes all items matching the specified query. You can change this behavior by specifying one of the follow keys:

To delete an item identified by a transient reference, on iOS, specify kSecValueRef with a item reference. On macOS, give a kSecMatchItemList containing an item reference. To delete an item identified by a persistent reference, on iOS, specify kSecValuePersistentRef with a persistent reference returned by using the kSecReturnPersistentRef key to SecItemCopyMatching or SecItemAdd. On macOS, use kSecMatchItemList with a persistent reference returned by using the kSecReturnPersistentRef key with SecItemCopyMatching or SecItemAdd. To delete multiple items specify kSecMatchItemList with an array of references. If more than one of these result keys is specified, the behavior is undefined.

§Safety

query generics must be of the correct type.