KM_ModifyBoolAttrs
Toggles the Boolean attributes of an object.
NOTE This function uses the following callback:
Synopsis
#include <kmlib.h>
CK_RV KM_ModifyBoolAttrs (
CK_SESSION_HANDLE hSession,
CK_CHAR * pUserPin,
CK_SIZE userPinLen,
CK_CHAR * pSoPin,
CK_SIZE soPinLen,
CK_OBJECT_HANDLE hObj,
CK_ATTRIBUTE_TYPE * pAttrs,
CK_COUNT numAttrs
);
Parameter | Description |
---|---|
hSession | Handle to an open session. |
pUserPin | Token User’s PIN. If setting the CKA_EXPORT attribute, then the Token SO PIN is required. In this case, the session is logged out, then the SO is logged in to perform the operation, and eventually the User is logged back in. |
userPinLen | Length of the users PIN. |
pSoPin |
Token SO PIN. If setting the CKA_EXPORT attribute, then the Token SO PIN is required. In this case, the session is logged out, then the SO is logged in to perform the operation, and eventually the User is logged back in. If the SO PIN is not provided, and is required, then it is prompted for. |
soPinLen | Length of the SO PIN. |
hObj | Handle to the object whose attributes are to be toggled. |
pAttrs |
Array of attribute types to modify. Each attribute specified in the array will be toggled. |
numAttrs |
The number of attributes to be toggled. |
Returns
CKR_ARGUMENTS_BAD
CKR_ATTRIBUTE_SENSITIVE
CKR_ATTRIBUTE_TYPE_INVALID
CKR_BUFFER_TOO_SMALL
CKR_CRYPTOKI_NOT_INITIALIZED
CKR_DEVICE_ERROR
CKR_DEVICE_MEMORY
CKR_DEVICE_REMOVED
CKR_FUNCTION_FAILED
CKR_GENERAL_ERROR
CKR_HOST_MEMORY
CKR_OBJECT_HANDLE_INVALID
CKR_OK
CKR_PIN_EXPIRED
CKR_PIN_INCORRECT
CKR_PIN_LOCKED
CKR_SESSION_CLOSED
CKR_SESSION_HANDLE_INVALID
CKR_SESSION_READ_ONLY_EXISTS
CKR_TEMPLATE_INCONSISTENT
CKR_USER_ALREADY_LOGGED_IN
CKR_USER_ANOTHER_ALREADY_LOGGED_IN
CKR_USER_NOT_LOGGED_IN
CKR_USER_PIN_NOT_INITIALIZED
CKR_USER_TOO_MANY_TYPES
CKR_USER_TYPE_INVALID