![]() |
![]() |
|
|
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 アルゴリズム・オブジェクト識別子を示します。
指定された属性に関連付けられている情報は、ユーザ定義の ATTVALUE-REC に格納され、末尾には SPACES が埋められます。 この位置に格納できる最大データ量は、TPKEYDEF-REC 内の ATTRIBUTE-LEN の呼び出しで指定します。 TPKEYGETINFO() が完了すると、ATTRIBUTE-LEN には実際に返されたデータの大きさが設定されます (埋め込み値を除く)。 返されるべきバイト数が ATTRIBUTE-VALUE-LEN を超える場合、TPKEYGETINFO() は (TPELIMIT エラー・コードを示して) 異常終了し、必要なスペースを ATTRIBUTE-VALUE-LEN に設定します。 戻り値 TPKEYGETINFO() は正常終了時には、TPSTATUS-REC 内の TP-STATUS に [TPOK] を設定します。 エラー TPKEYGETINFO() は異常終了時には、TPSTATUS-REC 内の TP-STATUS に次のいずれかの値を設定します。
関連項目
TPKEYCLOSE(3cbl)、TPKEYOPEN(3cbl)、TPKEYSETINFO(3cbl)
![]() |
![]() |
![]() |
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|