You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
81 lines
3.9 KiB
81 lines
3.9 KiB
9 years ago
|
/*
|
||
|
|
* Copyright (c) 2000-2011 Apple Inc. All Rights Reserved.
|
||
|
|
*
|
||
|
|
* @APPLE_LICENSE_HEADER_START@
|
||
|
|
*
|
||
|
|
* This file contains Original Code and/or Modifications of Original Code
|
||
|
|
* as defined in and that are subject to the Apple Public Source License
|
||
|
|
* Version 2.0 (the 'License'). You may not use this file except in
|
||
|
|
* compliance with the License. Please obtain a copy of the License at
|
||
|
|
* http://www.opensource.apple.com/apsl/ and read it before using this
|
||
|
|
* file.
|
||
|
|
*
|
||
|
|
* The Original Code and all software distributed under the License are
|
||
|
|
* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
|
||
|
|
* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
|
||
|
|
* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
|
||
|
|
* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
|
||
|
|
* Please see the License for the specific language governing rights and
|
||
|
|
* limitations under the License.
|
||
|
|
*
|
||
|
|
* @APPLE_LICENSE_HEADER_END@
|
||
|
|
*/
|
||
|
|
|
||
|
|
/*!
|
||
|
|
@header SecKeychainSearch
|
||
|
|
The functions provided in SecKeychainSearch implement a query of one or more keychains to search for a particular SecKeychainItem.
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _SECURITY_SECKEYCHAINSEARCH_H_
|
||
|
|
#define _SECURITY_SECKEYCHAINSEARCH_H_
|
||
|
|
|
||
|
|
#include <Security/SecKeychainItem.h>
|
||
|
|
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
CF_ASSUME_NONNULL_BEGIN
|
||
|
|
|
||
|
|
/*!
|
||
|
|
@function SecKeychainSearchGetTypeID
|
||
|
|
@abstract Returns the type identifier of SecKeychainSearch instances.
|
||
|
|
@result The CFTypeID of SecKeychainSearch instances.
|
||
|
|
@discussion This API is deprecated in 10.7. The SecKeychainSearchRef type is no longer used.
|
||
|
|
*/
|
||
|
|
CFTypeID SecKeychainSearchGetTypeID(void)
|
||
|
|
DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER;
|
||
|
|
|
||
|
|
/*!
|
||
|
|
@function SecKeychainSearchCreateFromAttributes
|
||
|
|
@abstract Creates a search reference matching a list of zero or more specified attributes in the specified keychain.
|
||
|
|
@param keychainOrArray An reference to an array of keychains to search, a single keychain or NULL to search the user's default keychain search list.
|
||
|
|
@param itemClass The keychain item class.
|
||
|
|
@param attrList A pointer to a list of zero or more keychain attribute records to match. Pass NULL to match any keychain attribute.
|
||
|
|
@param searchRef On return, a pointer to the current search reference. You are responsible for calling the CFRelease function to release this reference when finished with it.
|
||
|
|
@result A result code. See "Security Error Codes" (SecBase.h).
|
||
|
|
@discussion This function is deprecated in Mac OS X 10.7 and later; to find keychain items which match specified attributes, please use the SecItemCopyMatching API (see SecItem.h).
|
||
|
|
*/
|
||
|
|
OSStatus SecKeychainSearchCreateFromAttributes(CFTypeRef __nullable keychainOrArray, SecItemClass itemClass, const SecKeychainAttributeList * __nullable attrList, SecKeychainSearchRef * __nonnull CF_RETURNS_RETAINED searchRef)
|
||
|
|
DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER;
|
||
|
|
|
||
|
|
/*!
|
||
|
|
@function SecKeychainSearchCopyNext
|
||
|
|
@abstract Finds the next keychain item matching the given search criteria.
|
||
|
|
@param searchRef A reference to the current search criteria. The search reference is created in the SecKeychainSearchCreateFromAttributes function and must be released by calling the CFRelease function when you are done with it.
|
||
|
|
@param itemRef On return, a pointer to a keychain item reference of the next matching keychain item, if any.
|
||
|
|
@result A result code. When there are no more items that match the parameters specified to SecPolicySearchCreate, errSecItemNotFound is returned. See "Security Error Codes" (SecBase.h).
|
||
|
|
@discussion This function is deprecated in Mac OS X 10.7 and later; to find keychain items which match specified attributes, please use the SecItemCopyMatching API (see SecItem.h).
|
||
|
|
*/
|
||
|
|
OSStatus SecKeychainSearchCopyNext(SecKeychainSearchRef searchRef, SecKeychainItemRef * __nonnull CF_RETURNS_RETAINED itemRef)
|
||
|
|
DEPRECATED_IN_MAC_OS_X_VERSION_10_7_AND_LATER;
|
||
|
|
|
||
|
|
CF_ASSUME_NONNULL_END
|
||
|
|
|
||
|
|
#if defined(__cplusplus)
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* !_SECURITY_SECKEYCHAINSEARCH_H_ */
|