FC_UnwrapKey¶
Name¶
FC_UnwrapKey - unwrap a key
Syntax¶
CK_RV FC_UnwrapKey(
CK_SESSION_HANDLE hSession,
CK_MECHANISM_PTR pMechanism,
CK_OBJECT_HANDLE hUnwrappingKey,
CK_BYTE_PTR pWrappedKey,
CK_ULONG usWrappedKeyLen,
CK_ATTRIBUTE_PTR pTemplate,
CK_ULONG usAttributeCount,
CK_OBJECT_HANDLE_PTR phKey
);
Parameters¶
hSession[in] session handle.
pMechanism[in] pointer to the mechanism to use.
hUnwrappingKey[in] handle of the ket to use for unwrapping.
pWrappedKey[in] pointer to the wrapped key.
usWrappedKeyLen[in] length of the wrapped key.
pTemplate[in] pointer to the list of attributes for the unwrapped key.
usAttributeCount[in] number of attributes in the template.
phKey[out] pointer to the location to receive the handle of the unwrapped key.
Description¶
FC_UnwrapKey unwraps (decrypts) a key and creates a new key opbject. If pWrappedKey is
NULL the length of the wrapped key is returned in pusWrappedKeyLen and FC_UnwrapKey may be
called again with pWrappedKey set to retrieve the wrapped key.
A user must log into the token (to assume the NSS User role) before calling FC_UnwrapKey.