Function

SecKeychainItemDelete

Deletes a keychain item from the default keychain’s permanent data store.

Declaration

OSStatus SecKeychainItemDelete(SecKeychainItemRef itemRef);

Parameters

itemRef

A keychain item object of the item to delete. You must call the CFRelease function to release this object when you are finished using it.

Return Value

Discussion

If the keychain item has not previously been added to the keychain, this function does nothing and returns noErr.

Do not delete a keychain item and recreate it in order to modify it; instead, use the SecKeychainItemModifyContent or SecKeychainItemModifyAttributesAndData function to modify an existing keychain item. When you delete a keychain item, you lose any access controls and trust settings added by the user or by other applications.

See Also

Legacy Keychain Item Management

SecKeychainItemCopyAttributesAndData

Retrieves the data and/or attributes stored in the given keychain item.

SecKeychainItemModifyAttributesAndData

Updates an existing keychain item after changing its attributes or data.

SecKeychainItemFreeAttributesAndData

Releases the memory used by the keychain attribute list and/or the keychain data retrieved in a call to SecKeychainItemCopyAttributesAndData.

SecKeychainItemCopyContent

Copies the data and attributes stored in the given keychain item.

SecKeychainItemModifyContent

Updates an existing keychain item after changing its attributes and/or data.

SecKeychainItemFreeContent

Releases the memory used by the keychain attribute list and the keychain data retrieved in a call to the SecKeychainItemCopyContent function.

SecKeychainItemCopyKeychain

Returns the keychain object of a given keychain item.

SecKeychainAttrType

The keychain attribute type.

SecKeychainAttribute

A structure that holds a single keychain attribute.

SecKeychainAttributePtr

A pointer to a keychain attribute structure.

SecKeychainAttributeList

A list of keychain attributes.