Method
GckSessionunwrap_key
Declaration [src]
GckObject*
gck_session_unwrap_key (
GckSession* self,
GckObject* wrapper,
gulong mech_type,
const guchar* input,
gsize n_input,
GckAttributes* attrs,
GCancellable* cancellable,
GError** error
)
Description [src]
Unwrap a key from a byte stream. This call may block for an indefinite period.
If attrs is a floating reference, it is consumed.
Parameters
wrapper-
Type:
GckObjectThe key to use for unwrapping.
The data is owned by the caller of the function. mech_type-
Type:
gulongThe mechanism to use for unwrapping.
input-
Type: An array of
gucharThe wrapped data as a byte stream.
The length of the array is specified in the n_inputargument.The data is owned by the caller of the function. n_input-
Type:
gsizeThe length of the wrapped data.
attrs-
Type:
GckAttributesAdditional attributes for the unwrapped key.
The data is owned by the caller of the function. cancellable-
Type:
GCancellableOptional cancellation object, or
NULL.The argument can be NULL.The data is owned by the caller of the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: GckObject
The new unwrapped key or NULL if the
operation failed.
| The caller of the method takes ownership of the data, and is responsible for freeing it. |