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`	`GckObject`
	The key to use for unwrapping.
	The data is owned by the caller of the function.
`mech_type`	`gulong`
	The mechanism to use for unwrapping.
`input`	An array of `guchar`
	The wrapped data as a byte stream.
	The length of the array is specified in the `n_input` argument.
	The data is owned by the caller of the function.
`n_input`	`gsize`
	The length of the wrapped data.
`attrs`	`GckAttributes`
	Additional attributes for the unwrapped key.
	The data is owned by the caller of the function.
`cancellable`	`GCancellable`
	Optional cancellation object, or `NULL`.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`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.