Finds the first objects matching criteria

Namespace:  Cryptware.NCryptoki
Assembly:  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.

Exceptions

ExceptionCondition
Cryptware.NCryptoki..::..CryptokiExceptionIf a PKCS#11 error occurs

See Also