TElPKCS11AttributeList.Add method

TElPKCS11AttributeList.Add

Adds attribute to the list.

Declaration

[C#]
    int Add();
    int Add(uint Attribute, byte[] Value);
    int Add(uint Attribute, uint Value);
    int Add(uint Attribute, bool Value);

[VB.NET]
    Function Add() As Integer
    Function Add(ByVal Attribute As UInt32, ByVal Value As Byte()) As Integer
    Function Add(ByVal Attribute As UInt32, ByVal Value As UInt32) As Integer
    Function Add(ByVal Attribute As UInt32, ByVal Value As Boolean) As Integer

[Pascal]
    function Add : integer;
    function Add(Attribute: Cardinal; const Value: ByteArray) : integer;
    function Add(Attribute: Cardinal; Value: Cardinal) : integer;
    function Add(Attribute: Cardinal; Value: boolean) : integer;

[C++]
    int32_t Add();
    int32_t Add(uint32_t Attribute, const std::vector<uint8_t> &Value);
    int32_t Add(uint32_t Attribute, uint32_t Value);
    int32_t Add(uint32_t Attribute, bool Value);

[PHP]
    integer Add()
    integer Add(integer $Attribute, array of byte|string|NULL $Value)
    integer Add(integer $Attribute, integer $Value)
    integer Add(integer $Attribute, bool $Value)

[Java]
    int add(long Attribute, byte[] Value);
    int add();
    int add(long Attribute, long Value);
    int add(long Attribute, boolean Value);

Parameters

Attribute - PKCS#11 attribute code
Value - Value which should be assigned to the attribute

Attribute codes:

[.NET] [Pascal] [C++]		Value
CKA_CLASS		0 (0x000)
CKA_TOKEN		1 (0x001)
CKA_PRIVATE		2 (0x002)
CKA_MODIFIABLE		368 (0x170)
CKA_LABEL		3 (0x003)
CKA_APPLICATION		16 (0x010)
CKA_VALUE		17 (0x011)
CKA_OBJECT_ID		18 (0x012)
CKA_CERTIFICATE_TYPE		128 (0x080)
CKA_ISSUER		129 (0x081)
CKA_SERIAL_NUMBER		130 (0x082)
CKA_AC_ISSUER		131 (0x083)
CKA_OWNER		132 (0x084)
CKA_ATTR_TYPES		133 (0x085)
CKA_VALUE_LEN		353 (0x161)
CKA_TRUSTED		134 (0x086)
CKA_CERTIFICATE_CATEGORY		135 (0x087)
CKA_URL		136 (0x088)
CKA_KEY_TYPE		256 (0x100)
CKA_SUBJECT		257 (0x101)
CKA_ID		258 (0x102)
CKA_SENSITIVE		259 (0x103)
CKA_ENCRYPT		260 (0x104)
CKA_DECRYPT		261 (0x105)
CKA_WRAP		262 (0x106)
CKA_UNWRAP		263 (0x107)
CKA_SIGN		264 (0x108)
CKA_SIGN_RECOVER		265 (0x109)
CKA_VERIFY		266 (0x10A)
CKA_VERIFY_RECOVER		267 (0x10B)
CKA_DERIVE		268 (0x10C)
CKA_START_DATE		272 (0x110)
CKA_END_DATE		273 (0x111)
CKA_LOCAL		255 (0x163)
CKA_MODULUS		288 (0x120)
CKA_MODULUS_BITS		289 (0x121)
CKA_PUBLIC_EXPONENT		290 (0x122)
CKA_PRIVATE_EXPONENT		291 (0x123)
CKA_PRIME_1		292 (0x124)
CKA_PRIME_2		293 (0x125)
CKA_EXPONENT_1		294 (0x126)
CKA_EXPONENT_2		292 (0x127)
CKA_COEFFICIENT		293 (0x128)
CKA_PRIME		295 (0x130)
CKA_SUBPRIME		296 (0x131)
CKA_BASE		297 (0x132)
CKA_EXTRACTABLE		354 (0x162)
CKA_NEVER_EXTRACTABLE		356 (0x164)
CKA_ALWAYS_SENSITIVE		357 (0x165)
CKA_WRAP_WITH_TRUSTED		528 (0x210)
CKA_CHECK_VALUE		144 (0x090)
CKA_PRIME_BITS		307 (0x133)
CKA_SUBPRIME_BITS		308 (0x134)
CKA_ALWAYS_AUTHENTICATE		514 (0x202)
CKA_HASH_OF_SUBJECT_PUBLIC_KEY		138 (0x08A)
CKA_HASH_OF_ISSUER_PUBLIC_KEY		139 (0x08B)
CKA_JAVA_MIDP_SECURITY_DOMAIN		136 (0x088)
CKA_ECDSA_PARAMS		384 (0x180)
CKA_EC_PARAMS		384 (0x180)
CKA_EC_POINT		385 (0x181)
CKA_UNDEFINED		-1 (0xFFFFFFFF)

Return value

Index of the newly added item in the list.

Description

Use this method to add an attribute to the list. Use an appropriate overload of this method depending of the data type of the attribute. Attribute codes and corresponding data types are described in PKCS #11: Cryptographic Token Interface Standard.