Keychain/SecKeychainAPI.cpp

   1 /*
   2  * Copyright (c) 2000-2002 Apple Computer, Inc. All Rights Reserved.
   3  *
   4  * The contents of this file constitute Original Code as defined in and are
   5  * subject to the Apple Public Source License Version 1.2 (the 'License').
   6  * You may not use this file except in compliance with the License. Please obtain
   7  * a copy of the License at http://www.apple.com/publicsource and read it before
   8  * using this file.
   9  *
  10  * This Original Code and all software distributed under the License are
  11  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
  12  * OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, INCLUDING WITHOUT
  13  * LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
  14  * PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. Please see the License for the
  15  * specific language governing rights and limitations under the License.
  16  */
  17
  18 /*
  19  *  SecKeychainAPI.h
  20  *  SecurityCore
  21  *
  22  *    Copyright:  (c) 2000-2002 by Apple Computer, Inc., all rights reserved
  23  *
  24  */
  25
  26 /*!
  27         @header SecKeychainAPI The Security Keychain API contains all the APIs need to create a client and Keychain management application. It also contains a certificate, policy, identity and trust management API.
  28
  29         NOTE: Any function with Create or Copy in the name returns an object that must be released.
  30 */
  31
  32 #if !defined(SECURITY_USE_LEGACY_HEADER)
  33 #define SECURITY_USE_LEGACY_HEADER
  34 #define UNDEFINE_SECURITY_USE_LEGACY_HEADER
  35 #endif
  36
  37 #include <Security/SecKeychainAPI.h>
  38
  39 #ifdef UNDEFINE_SECURITY_USE_LEGACY_HEADER
  40 #undef SECURITY_USE_LEGACY_HEADER
  41 #undef UNDEFINE_SECURITY_USE_LEGACY_HEADER
  42 #endif
  43
  44 #include <Security/SecKeychainSearch.h>
  45 #include <Security/logging.h>
  46
  47 OSStatus SecKeychainRelease(SecKeychainRef keychainRef)
  48 {
  49         if (!keychainRef)
  50                 return errSecInvalidKeychain;
  51
  52         CFRelease(keychainRef);
  53         return noErr;
  54 }
  55
  56 OSStatus SecKeychainItemRelease(SecKeychainItemRef itemRef)
  57 {
  58         if (!itemRef)
  59                 return errSecInvalidItemRef;
  60
  61         CFRelease(itemRef);
  62         return noErr;
  63 }
  64
  65 OSStatus SecKeychainSearchRelease(SecKeychainSearchRef searchRef)
  66 {
  67         if (!searchRef)
  68                 return errSecInvalidSearchRef;
  69
  70         CFRelease(searchRef);
  71         return noErr;
  72 }
  73
  74 OSStatus SecKeychainCopySearchNextItem(SecKeychainSearchRef searchRef, SecKeychainItemRef *itemRef)
  75 {
  76         static bool warnonce;
  77         if (!warnonce)
  78         {
  79                 warnonce = true;
  80                 Syslog::warning("Calling OBSOLETE SecKeychainCopySearchNextItem please use SecKeychainSearchCopyNext instead");
  81         }
  82
  83         return SecKeychainSearchCopyNext(searchRef, itemRef);
  84 }
  85