Conforms to NSObject
Declared in WSCKeychainManager.h

Overview

The WSCKeychainManagerDelegate protocol defines optional methods for managing operations involving the deleting, setting, searching, etc. of keychains. When you use an WSCKeychainManager object to initiate a delete, set, search operations, the keychain manager asks its delegate whether the operation should begin at all and whether it should proceed when an error occurs.

Warning: You should associate your delegate with a unique instance of WSCKeychainManager class, as opposed to the shared instance.

Tasks

Creating Deleting a Keychain

Locking Keychains

Searching for Keychains Items

Instance Methods

keychainManager:shouldDeleteKeychain:

Asks the delegate whether the specified keychain should be deleted.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldDeleteKeychain:(WSCKeychain *)_Keychain

Parameters

_KeychainManager

The keychain manager that attempted to delete the specified keychain.

_Keychain

The keychain that the keychain manager tried to delete.

Return Value

YES if the specified keychain should be deleted or NO if it should not be deleted.

Discussion

Deleted keychains are deleted immediately and not placed in the Trash. If you do not implement this method, the keychain manager assumes a repsonse of YES.

See Also

Declared In

WSCKeychainManager.h

keychainManager:shouldLockKeychain:

Asks the delegate whether the specified keychain should be locked.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldLockKeychain:(WSCKeychain *)_Keychain

Parameters

_KeychainManager

The keychain manager that attempted to lock the specified keychain.

_Keychain

The keychain that the keychain manager tried to lock.

Return Value

YES if the specified keychain should be locked or NO if it should not be locked.

Discussion

If you do not implement this method, the keychain manager assumes a repsonse of YES.

See Also

Declared In

WSCKeychainManager.h

keychainManager:shouldProceedAfterError:deletingKeychain:

Asks the delegate if the operation should continue after an error occurs while deleting the specified keychain.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldProceedAfterError:(NSError *)_Error deletingKeychain:(WSCKeychain *)_Keychain

Parameters

_KeychainManager

The keychain manager that attempted to delete the specified keychain.

_Error

The error that occurred while attempting to delete the specified keychain.

_Keychain

The keychain that the keychain manager tried to delete.

Return Value

YES if the operation should proceed or NO if it should be aborted. If you do not implement this method, the keychain manager assumes a response of NO.

Discussion

The keychain manager calls this method when there is a problem deleting the keychain. If you return YES, the keychain manager continues deleting any remaining keychains and ignores the error.

See Also

Declared In

WSCKeychainManager.h

keychainManager:shouldProceedAfterError:lockingKeychain:

Asks the delegate if the operation should continue after an error occurs while locking the specified keychain.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldProceedAfterError:(NSError *)_Error lockingKeychain:(WSCKeychain *)_Keychain

Parameters

_KeychainManager

The keychain manager that attempted to lock the specified keychain.

_Error

The error that occurred while attempting to lock the specified keychain.

_Keychain

The keychain that the keychain manager tried to lock.

Return Value

YES if the operation should proceed or NO if it should be aborted. If you do not implement this method, the keychain manager assumes a response of NO.

See Also

Declared In

WSCKeychainManager.h

keychainManager:shouldProceedAfterError:updatingKeychainSearchList:

Asks the delegate if the operation should continue after an error occurs while updating the current default keychain search list.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldProceedAfterError:(NSError *)_Error updatingKeychainSearchList:(NSSet *)_SearchList

Parameters

_KeychainManager

The keychain manager that attempted to change the current default keychain search list.

_Error

The error that occurred while attempting to update the current default keychain search list.

_SearchList

A set of keychain objects (of class WSCKeychain) specifying the list of keychains to use in the new default keychain search list.

Return Value

YES if the operation should proceed or NO if it should be aborted. If you do not implement this method, the keychain manager assumes a response of NO.

See Also

Declared In

WSCKeychainManager.h

keychainManager:shouldUpdateKeychainSearchList:

Asks the delegate whether the current default keychain search list should be changed.

- (BOOL)keychainManager:(WSCKeychainManager *)_KeychainManager shouldUpdateKeychainSearchList:(NSSet *)_SearchList

Parameters

_KeychainManager

The keychain manager that attempted to change the current default keychain search list.

_SearchList

A set of keychain objects (of class WSCKeychain) specifying the list of keychains to use in the new default keychain search list.

Return Value

YES if the current default keychain search list should be updated or NO if it should not be updated.

Discussion

If you do not implement this method, the keychain manager assumes a repsonse of YES.

See Also

Declared In

WSCKeychainManager.h