index.rst (1640B)
1 .. _mozilla_projects_nss_reference_fc_signrecover: 2 3 FC_SignRecover 4 ============== 5 6 `Name <#name>`__ 7 ~~~~~~~~~~~~~~~~ 8 9 .. container:: 10 11 FC_SignRecover - Sign data in a single recoverable operation. 12 13 `Syntax <#syntax>`__ 14 ~~~~~~~~~~~~~~~~~~~~ 15 16 .. container:: 17 18 .. code:: 19 20 CK_RV FC_SignRecover( 21 CK_SESSION_HANDLE hSession, 22 CK_BYTE_PTR pData, 23 CK_ULONG usDataLen, 24 CK_BYTE_PTR pSignature, 25 CK_ULONG_PTR pusSignatureLen 26 ); 27 28 `Parameters <#parameters>`__ 29 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 30 31 .. container:: 32 33 ``hSession`` 34 [in] session handle. 35 ``pData`` 36 [in] mechanism to be used for the signing operation. 37 ``usDataLen`` 38 [in] handle of the key to be usedn. 39 ``pSignature`` 40 [out] pointer to the buffer or NULL. 41 ``pusSignatureLen`` 42 [in, out] pointer to the size of the output buffer, replaced by the length of the signature if 43 the operation is successful. 44 45 `Description <#description>`__ 46 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 47 48 .. container:: 49 50 ``FC_SignRecover`` signs data in a single operation where the (digest) data can be recovered from 51 the signature. If ``pSignature`` is NULL only the length of the signature is returned in 52 ``*pusSignatureLen``. 53 54 A user must log into the token (to assume the NSS User role) before calling ``FC_SignRecover``. 55 56 .. _return_value: 57 58 `Return value <#return_value>`__ 59 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 60 61 .. container:: 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_SignRecover </en-US/NSC_SignRecover>`__