COPSTAT - Operationszustand anzeigen/setzen

Der Makro COPSTAT umfasst folgende Funktionen der Sitzungsverwaltung:

• eine Kopie des Zustands der kryptographischen Operationen einer Sitzung ausgeben

• den Zustand der kryptographischen Operationen einer Sitzung wiederherstellen

Dieser Makroaufruf ist funktionslos. Die Schnittstelle ist jedoch aus Portabilitätsgründen in BS2000 implementiert.

Eine detaillierte Beschreibung zu den Funktionen des Makros COPSTAT finden Sie in PKCS#11 V2.20: Cryptographic Token Interface Standard im Abschnitt 11.6 „Session management functions“ unter „C_GetOperationState“ und „C_SetOperationState“.

Makro	Operanden
COPSTAT	MF=C / D / L / M / E ,ACTION=*GETOPERATIONSTATE / *SETOPERATIONSTATE / <var: enum-of _action_set: 1> / default: _action_set.undefined ,SESSION=<var: int:4> / <integer 0..2147483647> / 0 ,STATE=<var: pointer> / NULL ,STATEL=<var: int:4> / <integer 0..2147483647> / 0 ,CRYKEY=<var: int:4> / <integer 0..2147483647> / 0 ,AUTHKEY=<var: int:4> / <integer 0..2147483647> / 0

ACTION

Art der Aktion.
Die korrespondierende PKCS#11-Funktion ist bei jedem Aktionscode angegeben.

=*GETOPERATIONSTATE

entspricht der PKCS#11-Funktion C_GetOperationState;
gibt eine Kopie des Zustands der kryptographischen Operationen einer Sitzung aus.

=*SETOPERATIONSTATE

entspricht der PKCS#11-Funktion C_SetOperationState;
stellt den Zustand der kryptographischen Operationen einer Sitzung wieder her.

SESSION

Identifier der Sitzung

STATE

Zustand der kryptographischen Operation:

• *GETOPERATIONSTATE: Speicherbereich, der den Zustand empfängt

• *SETOPERATIONSTATE: Speicherbereich, an dem der gespeicherte Zustand abgelegt ist

STATEL

Länge des *...OPERATIONSTATE-Speicherbereichs

CRYKEY

Ver- und Entschlüsselungsschlüssel, nur bei *SETOPERATIONSTATE;*GETOPERATIONSTATE: CRYKEY wird nicht genutzt.

AUTHKEY

signiert/überprüft den Authentifikationsschlüssel,
nur bei *SETOPERATIONSTATE;
*GETOPERATIONSTATE: AUTHKEY wird nicht genutzt.