SecKeyChain.QueryAsData Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| QueryAsData(SecRecord, Boolean, Int32, SecStatusCode) |
Fetches a set of NSData records from the Keychain. |
| QueryAsData(SecRecord, Boolean, SecStatusCode) |
Fetches a set of NSData records from the Keychain. |
| QueryAsData(SecRecord) |
Fetches an NSData record from the Keychain. |
| QueryAsData(SecRecord, Int32) |
Fetches a set of NSData records from the Keychain. |
QueryAsData(SecRecord, Boolean, Int32, SecStatusCode)
Fetches a set of NSData records from the Keychain.
public static Foundation.NSData[] QueryAsData (Security.SecRecord query, bool wantPersistentReference, int max, out Security.SecStatusCode status);static member QueryAsData : Security.SecRecord * bool * int * -> Foundation.NSData[]Parameters
- query
- SecRecord
The query used to lookup the value on the keychain.
- wantPersistentReference
- Boolean
If set to true, the returned NSData can be stored on disk for later used, or shared between processes.
- max
- Int32
Maximum number of values to return.
- status
- SecStatusCode
Returns the status code from calling SecItemCopyMatching.
Returns
An array of NSData records associated with the given query.
Remarks
The returned NSData is a binary blob, if you want to get a high-level representation, use M:Security.SecKeyChain.QueryAsRecord* instead.
This is the strongly typed equivalent of calling the Security's framework SecItemCopyMatching method with the kSecReturnData set to true and kSecMatchLimit set to the value of max, forcing that many record to be returned. If wantPersistentReference is true, this also sets the kSecReturnPersistentRef dictionary key to true.
Applies to
QueryAsData(SecRecord, Boolean, SecStatusCode)
Fetches a set of NSData records from the Keychain.
public static Foundation.NSData QueryAsData (Security.SecRecord query, bool wantPersistentReference, out Security.SecStatusCode status);static member QueryAsData : Security.SecRecord * bool * -> Foundation.NSDataParameters
- query
- SecRecord
The query used to lookup the value on the keychain.
- wantPersistentReference
- Boolean
If set to true, the returned NSData can be stored on disk for later used, or shared between processes.
- status
- SecStatusCode
Returns the status code from calling SecItemCopyMatching.
Returns
The NSData associated with the given query.
Remarks
The returned NSData is a binary blob, if you want to get a high-level representation, use M:Security.SecKeyChain.QueryAsRecord* instead.
This is the strongly typed equivalent of calling the Security's framework SecItemCopyMatching method with the kSecReturnData set to true and kSecMatchLimit to 1, forcing a single record to be returned. If wantPersistentReference is true, this also sets the kSecReturnPersistentRef dictionary key to true.
Applies to
QueryAsData(SecRecord)
Fetches an NSData record from the Keychain.
public static Foundation.NSData QueryAsData (Security.SecRecord query);static member QueryAsData : Security.SecRecord -> Foundation.NSDataParameters
- query
- SecRecord
The query used to lookup the value on the keychain.
Returns
The NSData associated with the given query.
Remarks
The returned NSData is a binary blob, if you want to get a high-level representation, use M:Security.SecKeyChain.QueryAsRecord* instead.
The returned NSData is not suitable for storing on disk or passing to another process. If you want that, you should use the overload that takes the bool wantPersistentReference parameter and set that to true.
This is the strongly typed equivalent of calling the Security's framework SecItemCopyMatching method with the kSecReturnData set to true and kSecMatchLimit to 1, forcing a single record to be returned.
Applies to
QueryAsData(SecRecord, Int32)
Fetches a set of NSData records from the Keychain.
public static Foundation.NSData[] QueryAsData (Security.SecRecord query, int max);static member QueryAsData : Security.SecRecord * int -> Foundation.NSData[]Parameters
- query
- SecRecord
The query used to lookup the value on the keychain.
- max
- Int32
Maximum number of values to return.
Returns
An array of NSData records associated with the given query.
Remarks
The returned NSData is a binary blob, if you want to get a high-level representation, use M:Security.SecKeyChain.QueryAsRecord* instead.
The returned NSData is not suitable for storing on disk or passing to another process. If you want that, you should use the overload that takes the bool wantPersistentReference parameter and set that to true.
This is the strongly typed equivalent of calling the Security's framework SecItemCopyMatching method with the kSecReturnData set to true and kSecMatchLimit set to the value of max, forcing that many record to be returned.