9.13.3.4.10. Function Se05x_API_CreateCounter¶
Defined in File se05x_APDU_apis.h
9.13.3.4.10.1. Function Documentation¶
-
smStatus_t
Se05x_API_CreateCounter(pSe05xSession_t session_ctx, pSe05xPolicy_t policy, uint32_t objectID, uint16_t size)¶ Se05x_API_CreateCounter
Creates a new counter object.
Counters can only be incremented, not decremented.
When a counter reaches its maximum value (e.g., 0xFFFFFFFF for a 4-byte counter), they cannot be incremented again.
An input value (TAG_3) must always have the same length as the existing counter (if it exists); otherwise the command will return an error.
Command to Applet
Field
Value
Description
P1
P1_COUNTER
See
SE05x_P1_tP2
P2_DEFAULT
See
SE05x_P2_tPayload
TLV[TAG_POLICY]
Byte array containing the object policy. [Optional: default policy applies] [Conditional: only when the object identifier is not in use yet]
TLV[TAG_1]
4-byte counter identifier.
TLV[TAG_2]
2-byte counter size (1 up to 8 bytes). [Conditional: only if object doesn’t exist yet and TAG_3 is not given]
TLV[TAG_3]
Counter value [Optional: - if object doesn’t exist: must be present if TAG_2 is not given. - if object exists: if not present, increment by 1. if present, set counter to value.]
R-APDU Body
NA
R-APDU Trailer
NA
- Parameters
[in] session_ctx: Session Context [0:kSE05x_pSession][in] policy: policy [1:kSE05x_TAG_POLICY][in] objectID: object id [2:kSE05x_TAG_1][in] size: size [3:kSE05x_TAG_2]
