TPKEYGETINFO(3cbl)

名前

TPKEYGETINFO() - キー・ハンドルに関連付けられている情報の獲得

形式

01 TPKEYDEF-REC.
   COPY TPKEYDEF.

01 ATTVALUE-REC.
   COPY user data

01 TPSTATUS-REC.
   COPY TPSTATUS.

CALL "TPKEYGETINFO" USING TPKEYDEF-REC ATTVALUE-REC TPSTATUS-REC.

機能説明

TPKEYGETINFO() は、キー・ハンドルについての情報を報告します。 キー・ハンドルは、特定のプリンシパルのキーおよびそれに関連付けられている情報を表します。

呼び出し側プロセスは TPKEYDEF-REC 内の KEY-HANDLE を設定する必要があります。KEY-HANDLE は、事前の TPKEYOPEN() 呼び出しで返されるキー識別子です。

情報が必要な属性は、TPKEYDEF-REC 内の ATTRIBUTE-NAME によって識別されます。 属性名には、SPACES または LOW-VALUES を埋め込むことができます。 一部の属性は暗号サービス・プロバイダ固有のものですが、以下に示す属性は、すべてのプロバイダによってサポートされています。

アルゴリズム・オブジェクト識別子のアルゴリズムへのマッピング

ASN.1 DER アルゴリズム・オブジェクト識別子	アルゴリズム
{ 0x06, 0x08, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x02, 0x05 }	MD5
{ 0x06, 0x05, 0x2b, 0x0e, 0x03, 0x02, 0x1a }	SHA1
{ 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01 }	RSA
{ 0x06, 0x05, 0x2b, 0x0e, 0x03, 0x02, 0x0c }	DSA
{ 0x06, 0x05, 0x2b, 0x0e, 0x03, 0x02, 0x07 }	DES
{ 0x06, 0x08, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x03, 0x07 }	3DES
{ 0x06, 0x08, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x03, 0x02 }	RC2

 

TPKEYGETINFO() が完了すると、ATTRIBUTE-LEN には実際に返されたデータの大きさが設定されます (埋め込み値を除く)。 返されるべきバイト数が ATTRIBUTE-VALUE-LEN を超える場合、TPKEYGETINFO() は (TPELIMIT エラー・コードを示して) 異常終了し、必要なスペースを ATTRIBUTE-VALUE-LEN に設定します。

戻り値

TPKEYGETINFO() は正常終了時には、TPSTATUS-REC 内の TP-STATUS に [TPOK] を設定します。

エラー

TPKEYGETINFO() は異常終了時には、TPSTATUS-REC 内の TP-STATUS に次のいずれかの値を設定します。

関連項目