FC_GetTokenInfo¶
Name¶
FC_GetTokenInfo - obtain information about a particular token in the system.
Syntax¶
CK_RV FC_GetTokenInfo(CK_SLOT_ID slotID, CK_TOKEN_INFO_PTR pInfo);
Parameters¶
FC_GetTokenInfo
has two parameters:
slotID
the ID of the token’s slot
pInfo
points to a CK_TOKEN_INFO structure
Description¶
FC_GetTokenInfo
returns information about the token in the specified slot. On return, the
CK_TOKEN_INFO
structure that pInfo
points to has the following information:
label
: the label of the token, assigned during token initialization, padded with spaces to 32 bytes and not null-terminated.manufacturerID
: ID of the device manufacturer, “Mozilla Foundation”, padded with spaces to 32 characters and not null-terminated.model
: model of the device, “NSS 3”, padded with spaces to 16 characters and not null-terminated.serialNumber
: the device’s serial number as a string, “0000000000000000”, 16 characters and not null-terminated.flags
: bit flags indicating capabilities and status of the device.CKF_RNG (0x00000001)
: this device has a random number generatorCKF_WRITE_PROTECTED (0x00000002)
: this device is read-onlyCKF_LOGIN_REQUIRED (0x00000004)
: this device requires the user to log in to use some of its servicesCKF_USER_PIN_INITIALIZED (0x00000008)
: the user’s password has been initializedCKF_DUAL_CRYPTO_OPERATIONS (0x00000200)
: a single session with the token can perform dual cryptographic operationsCKF_TOKEN_INITIALIZED (0x00000400)
: the token has been initialized. If login is required (which is true for the FIPS mode of operation), this flag means the user’s password has been initialized.
ulSessionCount
: number of sessions that this application currently has open with the tokenulRwSessionCount
: number of read/write sessions that this application currently has open with the tokenhardwareVersion
: hardware version number, for example, 8.3 (major=0x08, minor=0x03
), which are the version numbers of the certificate and key databases, respectively.firmwareVersion
: firmware version number, 0.0 (major=0x00, minor=0x00
).
A user may call FC_GetTokenInfo
without logging into the token (to assume the NSS User role).
Return value¶
CKR_OK
Token information was successfully copied.
CKR_CRYPTOKI_NOT_INITIALIZED
The PKCS #11 module library is not initialized.
CKR_SLOT_ID_INVALID
The specified slot number is out of the defined range of values.
Note
FC_GetTokenInfo should return CKR_ARGUMENTS_BAD if pInfo is NULL.
Examples¶
Note the use of the %.32s
format string to print the label
and manufacturerID
members
of the CK_TOKEN_INFO
structure.