index.rst (1500B)
1 .. _mozilla_projects_nss_reference_fc_verify: 2 3 FC_Verify 4 ========= 5 6 `Name <#name>`__ 7 ~~~~~~~~~~~~~~~~ 8 9 .. container:: 10 11 FC_Verify - sign a block of data. 12 13 `Syntax <#syntax>`__ 14 ~~~~~~~~~~~~~~~~~~~~ 15 16 .. container:: 17 18 .. code:: 19 20 CK_RV FC_Verify( 21 CK_SESSION_HANDLE hSession, 22 CK_BYTE_PTR pData, 23 CK_ULONG usDataLen, 24 CK_BYTE_PTR pSignature, 25 CK_ULONG usSignatureLen 26 ); 27 28 `Parameters <#parameters>`__ 29 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 30 31 .. container:: 32 33 ``hSession`` 34 [in] session handle. 35 ``pData`` 36 [in] pointer to data block. 37 ``usDataLen`` 38 [in] length of the data in bytes. 39 ``pSignature`` 40 [in] pointer to the signature. 41 ``usSignatureLen`` 42 [in] length of the signature in bytes. 43 44 `Description <#description>`__ 45 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 46 47 .. container:: 48 49 ``FC_Verify`` verifies a signature in a single-part operation, where the signature is an appendix 50 to the data. 51 52 A user must log into the token (to assume the NSS User role) before calling ``FC_Verify``. 53 54 .. _return_value: 55 56 `Return value <#return_value>`__ 57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 58 59 .. container:: 60 61 ``CKR_OK`` is returned on success. ``CKR_SIGNATURE_INVALID`` is returned for signature mismatch. 62 63 `Examples <#examples>`__ 64 ~~~~~~~~~~~~~~~~~~~~~~~~ 65 66 .. container:: 67 68 .. _see_also: 69 70 `See also <#see_also>`__ 71 ~~~~~~~~~~~~~~~~~~~~~~~~ 72 73 .. container:: 74 75 - :ref:`mozilla_projects_nss_reference_fc_verifyinit`, `NSC_Verify </en-US/NSC_Verify>`__