CPIN - initialize or modify PIN

The CPIN macro initializes or modifies a PIN.

This macro call has no function. The interface is implemented for reasons of portability within BS2000.

A detailed description of the functions of the CPIN macro can be found in PKCS#11 V2.20: Cryptographic Token Interface Standard in section 11.5 “Slot and token management functions” under “C_InitPIN” and “C_SetPIN”.

Macro	Operands
CPIN	MF=C / D / L / M / E ,ACTION=*INITPIN / *SETPIN / <var: enum-of _action_set: 1> / default: _action_set.undefined ,SESSION=<var: int:4> / <integer 0..2147483647> / 0 ,OLDPIN=<var: pointer> / NULL ,OLDPINL=<var: int:4> / <integer 0..2147483647> / 0 ,NEWPIN=<var: pointer> / NULL ,NEWPINL=<var: int:4> / <integer 0..2147483647> / 0

ACTION

Type of action.
The corresponding PKCS#11 function is specified for each action code.

=*INITPIN

corresponds to the PKCS#11 function C_InitPIN;
initializes a PIN.

=*SETPIN

corresponds to the PKCS#11 function C_SetPIN;
modifies a PIN.

SESSION

Session identifier

OLDPIN

points to the old PIN;
is not used for the action *INITPIN.

OLDPINL

Length of the old PIN in bytes;
is not used for the action *INITPIN.

NEWPIN

points to the new PIN.

NEWPINL

Length of the new PIN in bytes.