gnutls_pkcs11_token_set_pin3
Api function
Usage
#include <gnutls/pkcs11.h>
int gnutls_pkcs11_token_set_pin(const char * token_url, const char * oldpin, const char * newpin, unsigned int flags);
Arguments
const char * token_url
|
A PKCS |
|---|---|
const char * oldpin
|
old user's PIN |
const char * newpin
|
new user's PIN |
unsigned int flags
|
one of |
Overview
This function will modify or set a user or administrator's PIN for the given token. If it is called to set a PIN for first time the oldpin must be NULL. When setting the admin's PIN with the GNUTLS_PIN_SO flag, the oldpin value must be provided (this requirement is relaxed after GnuTLS 3.6.5 since which the PIN will be requested if missing).
Returns
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.
Releases
7 releases since Debian 8 (Jessie); the text changed 6 times.