Cryptographic Token Interface Standard

PKCS#11


CK_C_INITIALIZE_ARGS Reference

CK_C_INITIALIZE_ARGS; CK_C_INITIALIZE_ARGS_PTR

CK_C_INITIALIZE_ARGS is a structure containing the optional arguments for the C_Initialize function. More...


Data Fields

CK_CREATEMUTEX CreateMutex
 pointer to a function to use for creating mutex objects. More...

CK_DESTROYMUTEX DestroyMutex
 pointer to a function to use for destroying mutex objects. More...

CK_LOCKMUTEX LockMutex
 pointer to a function to use for locking mutex objects. More...

CK_UNLOCKMUTEX UnlockMutex
 pointer to a function to use for unlocking mutex objects. More...

CK_FLAGS flags
 bit flags specifying options for '''C_Initialize'''; the flags are defined below. More...

CK_VOID_PTR pReserved
 reserved for future use. More...


Detailed Description

CK_C_INITIALIZE_ARGS; CK_C_INITIALIZE_ARGS_PTR

CK_C_INITIALIZE_ARGS is a structure containing the optional arguments for the C_Initialize function. For this version of Cryptoki, these optional arguments are all concerned with the way the library deals with threads. CK_C_INITIALIZE_ARGS is defined as follows:
CreateMutex pointer to a function to use for creating mutex objects
DestroyMutex pointer to a function to use for destroying mutex objects
LockMutex pointer to a function to use for locking mutex objects
UnlockMutex pointer to a function to use for unlocking mutex objects
flags bit flags specifying options for '''C_Initialize'''; the flags are defined below
pReserved reserved for future use. Should be NULL_PTR for this version of Cryptoki

The following table defines the flags field:

Table 14, C_Initialize Parameter Flags
Bit Flag Mask Meaning
CKF_LIBRARY_CANT_CREATE_OS_THREADS 0x00000001 True if application threads which are executing calls to the library may not use native operating system calls to spawn new threads; false if they may
CKF_OS_LOCKING_OK 0x00000002 True if the library can use the native operation system threading model for locking; false otherwise

CK_C_INITIALIZE_ARGS_PTR is a pointer to a CK_C_INITIALIZE_ARGS.


Field Documentation

CK_CREATEMUTEX CreateMutex
 

pointer to a function to use for creating mutex objects.

CK_DESTROYMUTEX DestroyMutex
 

pointer to a function to use for destroying mutex objects.

CK_LOCKMUTEX LockMutex
 

pointer to a function to use for locking mutex objects.

CK_UNLOCKMUTEX UnlockMutex
 

pointer to a function to use for unlocking mutex objects.

CK_FLAGS flags
 

bit flags specifying options for '''C_Initialize'''; the flags are defined below.

CK_VOID_PTR pReserved
 

reserved for future use. Should be NULL_PTR for this version of Cryptoki


RSA Security Inc. Public-Key Cryptography Standards - PKCS#11 - v230