index.rst (1344B)
1 .. _mozilla_projects_nss_reference_fc_setpin: 2 3 FC_SetPIN 4 ========= 5 6 `Name <#name>`__ 7 ~~~~~~~~~~~~~~~~ 8 9 .. container:: 10 11 FC_SetPIN - Modify the user's PIN. 12 13 `Syntax <#syntax>`__ 14 ~~~~~~~~~~~~~~~~~~~~ 15 16 .. container:: 17 18 .. code:: 19 20 CK_RV FC_SetPIN( 21 CK_SESSION_HANDLE hSession, 22 CK_CHAR_PTR pOldPin, 23 CK_ULONG ulOldLen, 24 CK_CHAR_PTR pNewPin, 25 CK_ULONG ulNewLen 26 ); 27 28 `Parameters <#parameters>`__ 29 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 30 31 .. container:: 32 33 ``FC_SetPIN`` takes five parameters: 34 35 ``hSession`` 36 [Input] the session's handle 37 ``pOldPin`` 38 [Input] points to the old PIN. 39 ``ulOldLen`` 40 [Input] the length in bytes of the old PIN. 41 ``pNewPin`` 42 [Input] points to the new PIN. 43 ``ulNewLen`` 44 [Input] the length in bytes of the new PIN. 45 46 `Description <#description>`__ 47 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 48 49 .. container:: 50 51 ``FC_SetPIN`` modifies the PIN of the user. The user must log into the token (to assume the NSS 52 User role) before calling ``FC_SetPIN``. 53 54 .. _return_value: 55 56 `Return value <#return_value>`__ 57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 58 59 .. container:: 60 61 ``CKR_OK`` 62 63 `Examples <#examples>`__ 64 ~~~~~~~~~~~~~~~~~~~~~~~~ 65 66 .. container:: 67 68 .. _see_also: 69 70 `See also <#see_also>`__ 71 ~~~~~~~~~~~~~~~~~~~~~~~~ 72 73 .. container:: 74 75 - `NSC_SetPIN </en-US/NSC_SetPIN>`__