index.md - mozsearch

Enable keyboard shortcuts

(mozilla-projects-nss-reference-fc-setpin)=

# FC_SetPIN

## [Name](#name)

:::{container}

FC_SetPIN - Modify the user's PIN.

:::

## [Syntax](#syntax)

:::{container}

```{code}

CK_RV FC_SetPIN(

  CK_SESSION_HANDLE hSession,

  CK_CHAR_PTR pOldPin,

  CK_ULONG ulOldLen,

  CK_CHAR_PTR pNewPin,

  CK_ULONG ulNewLen

);

```

:::

## [Parameters](#parameters)

:::{container}

`FC_SetPIN` takes five parameters:

`hSession`

: [Input] the session's handle

`pOldPin`

: [Input] points to the old PIN.

`ulOldLen`

: [Input] the length in bytes of the old PIN.

`pNewPin`

: [Input] points to the new PIN.

`ulNewLen`

: [Input] the length in bytes of the new PIN.

:::

## [Description](#description)

:::{container}

`FC_SetPIN` modifies the PIN of the user. The user must log into the token (to assume the NSS

User role) before calling `FC_SetPIN`.

:::

## [Return value](#return_value)

:::{container}

`CKR_OK`

:::

## [Examples](#examples)

## [See also](#see_also)

:::{container}

- [NSC_SetPIN](/en-US/NSC_SetPIN)

:::