Der Makro CGENRAL umfasst folgende allgemeine Funktionen:
Cryptoki-Bibliothek initialisieren
eine Anwendung mit der Cryptoki-Bibliothek beenden
allgemeine Informationen über Cryptoki ausgeben
Funktionsliste der Cryptoki-Bibliothek ausgeben
Alle Funktionen werden immer synchron ausgeführt
Eine detaillierte Beschreibung zu den Funktionen des Makros CGENRAL finden Sie in PKCS#11 V2.20: Cryptographic Token Interface Standard im Abschnitt 11.4 „Generalpurpose functions“.
Makro | Operanden |
CGENRAL | MF=C / D / L / M / E ,VERSION=001 / 002 ,ACTION= *INITIALIZE / *FINALIZE / *GETINFO / *GETFUNCTIONLIST / <var: enum-of ,EXEC=*SYNCHRON / *ASYNCHRON / <var: enum-of _exec_set:1> / default: _exec_set.synchron ,INFO=<var: pointer> / NULL ,BOID=<var: int:4> / 0 ,RPOSTAD=<var: pointer> / NULL ,RPOSTL=<integer 1..2> / <var: int:4> / 0 |
VERSION
gibt an, welche Version des Parameterbereichs generiert werden soll. Es empfiehlt sich, immer die neueste Version zu verwenden.
=001
Es wird das Format generiert, das von CRYPT V1.0 unterstützt wurde. Dieses Format unterstützt nur die bereits in CRYPT V1.0 bekannten Parameter.
VERSION=001 ist Voreinstellung.
=002
Es wird das Format generiert, das ab CRYPT V1.1 unterstützt wird.
ACTION
Art der Aktion.
Die korrespondierende PKCS#11-Funktion ist bei jedem Aktionscode angegeben.
=*INITIALIZE
entspricht der PKCS#11-Funktion C_Initialize;
initialisiert die Cryptoki-Bibliothek.
=*FINALIZE
entspricht der PKCS#11-Funktion C_Finalize;
zeigt an, dass eine Anwendung mit der Cryptoki-Bibliothek ausgeführt wurde.
=*GETINFO
entspricht der PKCS#11-Funktion C_GetInfo;
gibt allgemeine Information über Cryptoki aus.
=*GETFUNCTIONLIST
entspricht der PKCS#11-Funktion C_GetFunctionList;
gibt die Funktionsliste aus.
Diese Funktion wird nicht unterstützt.
EXEC
spezifiziert den Ausführungsmodus der folgenden Funktionen
=*SYNCHRON
gibt die Steuerung erst an den Aufrufenden zurück, nachdem die Funktion ausgeführt wurde.
=*ASYNCHRON
gibt die Steuerung an den Aufrufenden zurück, nachdem die Funktion an das Token gesandt wurde.
INFO
Art der ausgegebenen Information in Abhängigkeit von der Aktion:
*INITIALIZE: INFO zeigt auf eine _INITIALIZE_ARGS-Struktur
*FINALIZE: INFO sollte auf NULL_PTR gesetzt werden.
*GETINFO: INFO zeigt auf den Speicherbereich, der die Information empfängt.
*GETFUNCTIONLIST: INFO zeigt auf einen Wert, der einen Zeiger auf die _FUNCTION_LIST-Struktur der Bibliothek empfängt.
BOID
Ereigniskennung
bei synchroner Ausführung: BOID wird nicht genutzt
bei asynchroner Ausführung: Ereigniskennung, die das Programm über die Terminierung von CRYPT informiert.
RPOSTAD
Adresse des Postcodes
bei synchroner Ausführung: RPOSTAD wird nicht genutzt.
bei asynchroner Ausführung: spezifiziert ein Feld, das Postcode-Information enthält, die zum korrespondierenden Programm übertragen werden soll, das den SOLSIG-Aufruf absetzt (siehe auch Benutzerhandbuch „Makroaufrufe an den Ablaufteil“ [3]).
Länge des Postcodes: 4 oder 8 bytes
RPOSTL
Länge des Postcodes
bei synchroner Ausführung: RPOSTL wird nicht genutzt.
bei asynchroner Ausführung: gibt die Länge der Postcode-Information in Worten an (1 oder 2).