Carbon


KCReleaseSearch

Header: Keychain.h Carbon status: Under Evaluation

Disposes of the memory occupied by a search criteria reference.

OSStatus KCReleaseSearch (
    KCSearchRef *search
);
Parameter descriptions
search

A pointer to a search criteria reference. Pass the search criteria reference whose memory you want to release. On return, the reference is set to NULL and should not be used again.

function result

A result code. The result code errKCInvalidSearchRef indicates that the specified search reference was invalid.

DISCUSSION

You should call the KCReleaseSearch function to release the memory occupied by a search criteria reference when you are completely finished with a search performed by calling the functions KCFindFirstItem or KCFindNextItem.

VERSION NOTES

Available beginning with Keychain Manager 1.0


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