PKCS #11 Functions: C_GetTokenInfo()

C_GetTokenInfo() gets information about a specific token. C_GetTokenInfo() uses the following syntax:

C_GetTokenInfo(CK_SLOT_ID slotID, CK_TOKEN_INFO_PTR pInfo);

slotID identifies the slot for the token. slotID has to be a valid ID that was returned by C_GetSlotList(). pInfo is a pointer to the location to receive the token information.

If pkcs11_softtoken.so is the only installed provider, then C_GetTokenInfo() returns the following fields and values:

• label – Sun Software PKCS#11 softtoken.

• flags – CKF_DUAL_CRYPTO_OPERATIONS, CKF_TOKEN_INITIALIZED, CKF_RNG, CKF_USER_PIN_INITIALIZED, and CKF_LOGIN_REQUIRED, which are set to 1.

• ulMaxSessionCount – Set to CK_EFFECTIVELY_INFINITE.

• ulMaxRwSessionCount - Set to CK_EFFECTIVELY_INFINITE.

• ulMaxPinLen – Set to 256.

• ulMinPinLen – Set to 1.

• ulTotalPublicMemory set to CK_UNAVAILABLE_INFORMATION.

• ulFreePublicMemory set to CK_UNAVAILABLE_INFORMATION.

• ulTotalPrivateMemory set to CK_UNAVAILABLE_INFORMATION.

• ulFreePrivateMemory set to CK_UNAVAILABLE_INFORMATION.

In addition to CKR_FUNCTION_FAILED, CKR_GENERAL_ERROR, CKR_HOST_MEMORY, and CKR_OK, C_GetSlotlist() gets the following return values:

• CKR_ARGUMENTS_BAD

• CKR_BUFFER_TOO_SMALL

• CKR_CRYPTOKI_NOT_INITIALIZED

• CKR_SLOT_ID_INVALID

The following return values are relevant for plug-ins with hardware tokens:

• CKR_DEVICE_ERROR

• CKR_DEVICE_MEMORY

• CKR_DEVICE_REMOVED

• CKR_TOKEN_NOT_PRESENT

• CKR_TOKEN_NOT_RECOGNIZED