<HIDKey> Protocol Reference

Key instance. More...

#include <HIDKey.h>

Inheritance diagram for <HIDKey>:

Instance Methods
(NSString *)	- getAlgorithm:
	Gets the standard algorithm name for the key.
(id< HIDOTPGenerator >)	- getDefaultOTPGenerator:
	Returns the default OTP generator associated with the key.
(NSData *)	- getEncoded:
	Gets the key in its primary encoding format.
(NSData *)	- getEncoded:error:
	Gets the key in its primary encoding format.
(NSString *)	- getFormat:
	Gets the name of the primary encoding format of this key.
(HIDIdentifier *)	- getId
	Gets the keyId associated with key.
(NSString *)	- getProperty:error:
	Returns property for that key.
(id< HIDProtectionPolicy >)	- getProtectionPolicy:
	Gets the protection policy associated with key.
(BOOL)	- isExtractable:
	Returns true when the key is extractable.

Detailed Description

Key instance.

Method Documentation

getAlgorithm:

- (NSString *) getAlgorithm:

(NSError **)

error

Gets the standard algorithm name for the key.

Parameters

error

error details. It may be nil.

Returns

The algorithm name.

getDefaultOTPGenerator:

- (id< HIDOTPGenerator >) getDefaultOTPGenerator:

(NSError **)

error

Returns the default OTP generator associated with the key.

Parameters

error

error details. It may be nil.

Returns

The HIDOTPGenerator instance, nil if key is not supporting any OTP generators or an error occurs.

getEncoded:

- (NSData *) getEncoded:

(NSError **)

error

Gets the key in its primary encoding format.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDAuthentication if password is incorrect. HID_ERROR_AUTH_REMAINING_TRIES contains lock counter details when applicable.
• HIDInternal if unexpected error occurred.

Returns

the key in its primary encoding format, or nil if an error occurred

getEncoded:error:

- (NSData *) getEncoded:		(NSString *)	password
error:		(NSError **)	error

Gets the key in its primary encoding format.

Parameters

password	the key password.
error	error details. It may be nil.

Possible error codes are:

• HIDAuthentication if password is incorrect. HID_ERROR_AUTH_REMAINING_TRIES contains lock counter details when applicable.
• HIDInternal if unexpected error occurred.

Returns

The key in its primary encoding format, or nil if an error occurred.

getFormat:

- (NSString *) getFormat:

(NSError **)

error

Gets the name of the primary encoding format of this key.

Parameters

error

error details. It may be nil.

Returns

The encoding format name.

getId

- (HIDIdentifier *) getId

Gets the keyId associated with key.

Returns

the keyId, nil if not set.

getProperty:error:

- (NSString *) getProperty:		(NSString *)	propertyId
error:		(NSError **)	error

Returns property for that key.

Parameters

propertyId

key property name.

The property name may be any of the following:

• HID_KEY_PROPERTY_USAGE
• HID_KEY_PROPERTY_LABEL
• HID_KEY_PROPERTY_CREATE
• HID_KEY_PROPERTY_EXPIRY

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.

Returns

The key property value, nil if an error occurs.

getProtectionPolicy:

- (id< HIDProtectionPolicy >) getProtectionPolicy:

(NSError **)

error

Gets the protection policy associated with key.

Parameters

error

error details. It may be nil.

Possible error codes are:

• HIDInternal if unexpected error occurred.

Returns

The HIDProtectionPolicy used to protect the key, nil if an error occurs.

isExtractable:

- (BOOL) isExtractable:

(NSError **)

error

Returns true when the key is extractable.

Parameters

error

error details. It may be nil.

Returns

true or false depending on whether the key is extractable or not.