Struct SecIdentitySearch

Source

#[repr(C)]
pub struct SecIdentitySearch { /* private fields */ }

Available on crate feature SecIdentitySearch only.

Expand description

Contains information about an identity search.

Implementations§

Source §

impl SecIdentitySearch

Source

pub unsafe fn create( keychain_or_array: Option<&CFType>, key_usage: CSSM_KEYUSE, search_ref: mut mut SecIdentitySearch, ) -> i32

👎Deprecated

Available on crate features cssmconfig and cssmtype only.

Creates a search reference for finding identities.

Parameter keychainOrArray: An reference to an array of keychains to search, a single keychain, or NULL to search the user’s default keychain search list.

Parameter keyUsage: A CSSM_KEYUSE value, as defined in cssmtype.h. This value narrows the search to return only those identities which match the specified key usage. Pass a value of 0 to ignore key usage and return all available identities. Note that passing CSSM_KEYUSE_ANY limits the results to only those identities that can be used for every operation.

Parameter searchRef: On return, an identity search reference. You must release the identity search reference by calling the CFRelease function.

Returns: A result code. See “Security Error Codes” (SecBase.h).

You can set values for key usage, and one or more keychains, to control the search for identities. You can use the returned search reference to obtain the remaining identities in subsequent calls to the SecIentitySearchCopyNext function. You must release the identity search reference by calling the CFRelease function. This function is deprecated in Mac OS X 10.7 and later; to find identities which match a given key usage or other attributes, please use the SecItemCopyMatching API (see SecItem.h).

Source

pub unsafe fn copy_next( self: &SecIdentitySearch, identity: mut mut SecIdentity, ) -> i32

👎Deprecated

Available on crate feature SecBase only.

Finds the next identity matching the given search criteria, as previously specified by a call to SecIdentitySearchCreate or SecIdentitySearchCreateWithAttributes.

Parameter searchRef: A reference to the current identity search. You create the identity search reference by calling either SecIdentitySearchCreate or SecIdentitySearchCreateWithAttributes.

Parameter identity: On return, an identity reference for the next found identity, if any. You must call the CFRelease function when finished with the identity reference.

Returns: A result code. When there are no more identities found that match the search criteria, errSecItemNotFound is returned. See “Security Error Codes” (SecBase.h).

This function is deprecated in Mac OS X 10.7 and later; to find identities which match specified attributes, please use the SecItemCopyMatching API (see SecItem.h).

Methods from Deref<Target = CFType>§

Source

pub fn downcast_ref<T>(&self) -> Option<&T>
where T: ConcreteType,

Available on crate feature SecCustomTransform only.

Attempt to downcast the type to that of type T.

This is the reference-variant. Use CFRetained::downcast if you want to convert a retained type. See also ConcreteType for more details on which types support being converted to.

Source

pub fn retain_count(&self) -> usize

Available on crate feature SecCustomTransform only.

Get the reference count of the object.

This function may be useful for debugging. You normally do not use this function otherwise.

Beware that some things (like CFNumbers, small CFStrings etc.) may not have a normal retain count for optimization purposes, and can return usize::MAX in that case.