Functions


Creating and Disposing of Keychain Item References

KCNewItem Creates a reference to a keychain item.
KCReleaseItem Disposes of the memory occupied by a keychain item reference.

Creating and Disposing of Keychain References

KCMakeAliasFromKCRef Creates an alias to a keychain reference.
KCMakeKCRefFromAlias Creates a keychain reference from a keychain alias.
KCMakeKCRefFromFSSpec Creates a keychain reference from a file specification record.
KCReleaseKeychain Disposes of the memory associated with a keychain reference.

Getting Information About the Keychain Manager

KCGetKeychainManagerVersion Returns the version of the Keychain Manager.
KeychainManagerAvailable Determines whether the Keychain Manager is installed and available.

Managing Keychains

KCCountKeychains Determines the number of available keychains.
KCCreateKeychain Creates an empty keychain.
KCGetDefaultKeychain Obtains the default keychain.
KCGetIndKeychain Obtains the reference to an indexed keychain.
KCGetKeychainName Determines the name of a keychain.
KCGetStatus Determines the permissions that are set in a keychain.
KCSetDefaultKeychain Sets the default keychain.

Managing User Interaction

KCChangeSettings Displays a dialog box enabling the user to change the name, password, or settings of a keychain.
KCIsInteractionAllowed Indicates whether Keychain Manager functions that display a user interaction will do so.
KCLock Displays a dialog box that prompts the user for a password in order before locking keychain.
KCSetInteractionAllowed Enables or disables Keychain Manager functions that display a user interface.
KCUnlock Displays a dialog box that prompts the user for a password in order before unlocking keychain.

Manipulating Keychain Items

KCAddItem Adds a password or other keychain item to the default keychain.
KCCopyItem Copies a password or other keychain item from one keychain to another.
KCDeleteItem Deletes a password or other keychain item from the default keychain.
KCGetKeychain Determines the location of a password or other keychain item.
KCUpdateItem Updates a password or other keychain item.

Registering Your Keychain Event Callback Function

KCAddCallback Registers your keychain event callback function.
KCRemoveCallback Unregisters your keychain event callback function.

Searching for Keychain Items

KCFindFirstItem Finds the first keychain item in a specified keychain that matches specified attributes.
KCFindNextItem Finds the next keychain item matching the previously specified search criteria.
KCReleaseSearch Disposes of the memory occupied by a search criteria reference.

Setting and Obtaining Keychain Item Data

KCGetAttribute Determines keychain item data using a keychain item attribute structure.
KCGetData Determines keychain item data.
KCSetAttribute Sets or edits keychain item data using a keychain item attribute structure.
KCSetData Sets or edits keychain item data.

Storing and Retrieving Passwords

KCAddAppleSharePassword Adds a new AppleShare server password to the default keychain.
KCAddGenericPassword Adds a new generic password to the default keychain.
KCAddInternetPassword Adds a new Internet server password to the default keychain.
KCAddInternetPasswordWithPath Adds a new Internet server password with a specified path to the default keychain.
KCFindAppleSharePassword Finds the first AppleShare password in the default keychain that matches the specified parameters.
KCFindGenericPassword Finds the first generic password in the default keychain matching specified parameters.
KCFindInternetPassword Finds the first Internet password in the default keychain that matches the specified parameters.
KCFindInternetPasswordWithPath Finds the first Internet password in the default keychain that matches the specified parameters, including path information.

Working With Certificates

KCChooseCertificate Displays a list of certificates that the user can choose from.
KCFindX509Certificates Finds the certificates in a keychain that match specified search criteria.

Working With Your Keychain Manager Callback Function

DisposeKCCallbackUPP Disposes of a UPP to your keychain event callback.
InvokeKCCallbackUPP Invokes your keychain event callback.
NewKCCallbackUPP Creates a UPP to your keychain event callback.

Miscellaneous

KCDisplayTrustResults
KCDisplayX509Certificate
KCDisplayX509CertificateChain
KCItemRefArrayCallBacks
kcaddapplesharepassword
kcaddgenericpassword
kcaddinternetpassword
kcaddinternetpasswordwithpath
kccreatekeychain
kcfindapplesharepassword
kcfindgenericpassword
kcfindinternetpassword
kcfindinternetpasswordwithpath
kcgetkeychainname
kcunlock

© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)