Der Makro CGTSTMI umfasst folgende Funktionen der Slot- und Token-Verwaltung:
Liste der Slots im System ausgeben
Information über einen einzelnen Slot im System ausgeben
Information über ein einzelnes Token im System ausgeben
Liste der Typen von Mechanismen ausgeben, die von einem Token unterstützt werden
Information über einen einzelnen Mechanismus ausgeben, der von einem Token unterstützt wird
Die Funktionen C_GetMechanismList und C_GetMechanismInfo werden asynchron ausgeführt, falls für die Task mit C_Initialize asynchrone Funktionsausführung festgelegt wurde.
Die Funktionen C_GetSlotList, C_GetSlotInfo und C_GetTokenInfo werden immer synchron ausgeführt.
Eine detaillierte Beschreibung zu den Funktionen des Makros CGTSTMI finden Sie in PKCS#11 V2.20: Cryptographic Token Interface Standard im Abschnitt 11.5 „Slot and token management functions“ unter „C_GetSlotList“, „C_GetSlotInfo“, „C_Get TokenInfo“, „C_GetMechanismList“, „C_GetMechanismInfo“.
Makro | Operanden |
CGTSTMI | MF=C / D / L / M / E ,VERSION=001 / 002 ,ACTION=*GETSLOTLIST / *GETSLOTINFO / *GETTOKENINFO / *GETMECHANISMLIST / *GETMECHANISMINFO / <var: enum-of default: _action_set.undefined ,TOKNPRS=<var: int:1> / *TRUE / *FALSE / 0 ,SLOTID=<var: int:4> / <integer 0 .. 2147483647> / 0 ,TYPE=<var: int:4> / <integer 0 .. 2147483647> / 0 ,INFO=<var: pointer> / NULL ,COUNT=<var: int:4> / <integer 0 .. 2147483647> / 0 ,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.
=*GETSLOTLIST
entspricht der PKCS#11-Funktion C_GetSlotList;
gibt die Liste der Slots im System aus.
=*GETSLOTINFO
entspricht der PKCS#11-Funktion C_GetSlotInfo;
gibt Information über einen einzelnen Slot im System aus.
=*GETTOKENINFO
entspricht der PKCS#11-Funktion C_GetTokenInfo;
gibt Information über ein einzelnes Token im System aus.
=*GETMECHANISMLIST
entspricht der PKCS#11-Funktion C_GetMechanismList;
gibt die Liste der Typen von Mechanismen aus, die von einem Token unterstützt werden.
=*GETMECHANISMINFO
entspricht der PKCS#11-Funktion C_GetMechanismInfo;
gibt Information über einen einzelnen Mechanismus aus, der von einem Token unterstützt wird.
TOKNPRS
Information über aktuelle Token;
ist nur für die Aktion *GETSLOTLIST relevant.
=*TRUE
Ein Token muss vorhanden sein.
=*FALSE
Es spielt keine Rolle, ob ein Token vorhanden ist oder nicht.
SLOTID
ID des Slot
TYPE
Mechanismus-Typ: Wert von _mechanism_set (siehe auch Abschnitt „CPKC11T –Allgemeine Datentypen“);
ist nur für die Aktion *GETMECHANISMINFO relevant.
INFO
Art der ausgegebenen Information in Abhängigkeit von der Aktion:
*GETSLOTLIST: NULL_PTR oder Pointer auf einen Speicherbereich, der die Slot-Liste empfängt.
*GETSLOTINFO: INFO zeigt auf den Speicherbereich, der die Slot-Information empfängt.
*GETTOKENINFO: INFO zeigt auf den Speicherbereich, der die Token-Information empfängt.
*GETMECHANISMLIST: NULL_PTR oder Pointer auf einen Speicherbereich, der die Mechanismen-Liste empfängt.
*GETMECHANISMINFO: INFO zeigt auf den Speicherbereich, der die Information über den Mechanismus empfängt.
COUNT
Größe des Speichers in Abhängigkeit von der Aktion:
*GETSLOTLIST:
INFO = NULL_PTR: Die Anzahl der Slots wird zurückgegeben;
INFO <> NULL_PTR: muss die Größe des Speichers, auf den INFO zeigt, enthalten. Die Speichergröße entspricht der Anzahl von _SLOT_ID-Elementen.*GETSLOTINFO: COUNT wird nicht ausgewertet.
*GETTOKENINFO: COUNT wird nicht ausgewertet.
*GETMECHANISMLIST:
INFO = NULL_PTR: Die Anzahl der Slots wird zurückgegeben;
INFO <> NULL_PTR: muss die Größe des Speichers, auf den INFO zeigt, enthalten. Die Speichergröße entspricht der Anzahl von _MECHANISM_TYPE-Elementen.*GETMECHANISMINFO: COUNT wird nicht ausgewertet.
BOID
Ereigniskennung
bei synchroner Ausführung: BOID wird nicht genutzt.
bei asynchroner Ausführung: Ereigniskennung, an die das Ende der Funktionsbearbeitung signalisiert wird.
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).