index.rst (1442B)
1 .. _mozilla_projects_nss_reference_fc_findobjectsinit: 2 3 FC_FindObjectsInit 4 ================== 5 6 `Name <#name>`__ 7 ~~~~~~~~~~~~~~~~ 8 9 .. container:: 10 11 FC_FindObjectsInit - initialize the parameters for an object search. 12 13 `Syntax <#syntax>`__ 14 ~~~~~~~~~~~~~~~~~~~~ 15 16 .. container:: 17 18 .. code:: 19 20 CK_RV FC_FindObjectsInit( 21 CK_SESSION_HANDLE hSession, 22 CK_ATTRIBUTE_PTR pTemplate, 23 CK_ULONG usCount 24 ); 25 26 `Parameters <#parameters>`__ 27 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 28 29 .. container:: 30 31 ``hSession`` 32 [in] session handle. 33 ``pTemplate`` 34 [in] pointer to template. 35 ``usCount`` 36 [in] number of attributes in the template. 37 38 `Description <#description>`__ 39 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 40 41 .. container:: 42 43 ``FC_FindObjectsInit`` sets the attribute list for an object search. If ``FC_FindObjectsInit`` is 44 successful ``FC_FindObjects`` may be called one or more times to retrieve handles of matching 45 objects. 46 47 A user must log into the token (to assume the NSS User role) before searching for secret or 48 private key objects. 49 50 .. _return_value: 51 52 `Return value <#return_value>`__ 53 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 54 55 .. container:: 56 57 `Examples <#examples>`__ 58 ~~~~~~~~~~~~~~~~~~~~~~~~ 59 60 .. container:: 61 62 .. _see_also: 63 64 `See also <#see_also>`__ 65 ~~~~~~~~~~~~~~~~~~~~~~~~ 66 67 .. container:: 68 69 - :ref:`mozilla_projects_nss_reference_fc_findobjects`, 70 `NSC_FindObjectsInit </en-US/NSC_FindObjectsInit>`__