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.