Finds the first objects matching criteria
Namespace:
Cryptware.NCryptokiAssembly: NCryptoki (in NCryptoki.dll)
Syntax
Visual Basic (Declaration) |
---|
Public Function Find ( _ attList As CryptokiCollection _ ) As CryptokiObject |
C# |
---|
public CryptokiObject Find( CryptokiCollection attList ) |
Visual C++ |
---|
public: CryptokiObject^ Find( CryptokiCollection^ attList ) |
JavaScript |
---|
function find(attList); |
Parameters
- attList
- Type: Cryptware.NCryptoki..::..CryptokiCollection
List of attributes of the requested objects
Return Value
The object found or null otherwise
Remarks
Call C_FindObjectsInit, C_FindObjects, C_FindObjectsFinal of the underlying native PKCS#11
The object search operation will only find objects that the session can view. For example, an object search in an “R/W Public Session” will not find any private objects (even if one of the attributes in the search template specifies that the search is for private objects). If a search operation is active, and objects are created or destroyed which fit the search template for the active search operation, then those objects may or may not be found by the search operation. Note that this means that, under these circumstances, the search operation may return invalid object handles.
The object search operation will only find objects that the session can view. For example, an object search in an “R/W Public Session” will not find any private objects (even if one of the attributes in the search template specifies that the search is for private objects). If a search operation is active, and objects are created or destroyed which fit the search template for the active search operation, then those objects may or may not be found by the search operation. Note that this means that, under these circumstances, the search operation may return invalid object handles.
Exceptions
Exception | Condition |
---|---|
Cryptware.NCryptoki..::..CryptokiException | If a PKCS#11 error occurs |