blob: c45b254892be2c9ead85d85a8a2bc3418eae026e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
.. _mozilla_projects_nss_reference_fc_setoperationstate:
FC_SetOperationState
====================
`Name <#name>`__
~~~~~~~~~~~~~~~~
.. container::
FC_SetOperationState - restore the cryptographic operation state of a session.
`Syntax <#syntax>`__
~~~~~~~~~~~~~~~~~~~~
.. container::
.. code::
CK_RV FC_SetOperationState(
CK_SESSION_HANDLE hSession,
CK_BYTE_PTR pOperationState,
CK_ULONG ulOperationStateLen,
CK_OBJECT_HANDLE hEncryptionKey,
CK_OBJECT_HANDLE hAuthenticationKey
);
`Parameters <#parameters>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
``hSession``
[in] handle of the open session.
``pOperationState``
[in] pointer to a byte array containing the operation state.
``ulOperationStateLen``
[in] contains the total length (in bytes) of the operation state.
``hEncryptionKey``
[in] handle of the encryption or decryption key to be used in a stored session or zero if no
key is needed.
``hAuthenticationKey``
[in] handle of the authentication key to be used in the stored session or zero if none is
needed.
`Description <#description>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
``FC_SetOperationState`` restores the cryptographic operations state of a session from an array
of bytes obtained with ``FC_GetOperationState``. This function only works for digest operations
for now. Therefore, a user may call ``FC_SetOperationState`` without logging into the token (to
assume the NSS User role).
.. _return_value:
`Return value <#return_value>`__
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
`Examples <#examples>`__
~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
.. _see_also:
`See also <#see_also>`__
~~~~~~~~~~~~~~~~~~~~~~~~
.. container::
- :ref:`mozilla_projects_nss_reference_fc_getoperationstate`,
`NSC_SetOperationState </en-US/NSC_SetOperationState>`__
|