Secret.Value.unref_to_password

### Method

# Secret Valueunref_to_password

#### Declaration [src]

    gchar*
    secret_value_unref_to_password (
      SecretValue* value,
      gsize* length
    )

#### Description [src]

Unreference a `SecretValue` and steal the secret data in `SecretValue` as nonpageable memory.

Available since: | 0.19.0

#### Parameters

`length` | `gsize*`
| The length of the secret.
| The argument will be modified by the function.

#### Return value

Returns: | `gchar*`
| A new password string stored in nonpageable memory which must be freed with `secret_password_free()` when done.
| The caller of the method takes ownership of the data, and is responsible for freeing it.
| The value is a NUL terminated UTF-8 string.