bea ホーム | 製品 | dev2dev | support | askBEA |
![]() |
![]() |
|
![]() |
e-docs > Tuxedo > Tuxedo C リファレンス > セクション 3c - C 関数 |
Tuxedo C リファレンス
|
名前
tpkey_getinfo()−キー・ハンドルに関連付けられた情報の取得
形式
#include <atmi.h>
int tpkey_getinfo(TPKEY hKey, char *attribute_name, void *value, long *value_len, long flags)
機能説明
tpkey_getinfo() は、キー・ハンドルに関する情報を報告します。キー・ハンドルは、特定のプリンシパルのキーおよびそれに関連付けられている情報を表します。
調査対象のキーは、hKey 入力パラメータによって識別されます。情報が要求されている属性は、attribute_name 入力パラメータによって識別されます。暗号サービス・プロバイダ固有の属性もありますが、以下のような基本的属性はすべてのプロバイダがサポートしています。
デフォルトの公開鍵インプリメンテーションがサポートする ASN.1 DER アルゴリズムのオブジェクト識別子を、表 11 に示します。
指定された attribute_name パラメータに関連付けられている情報は、値によって示されるメモリ位置に格納されます。この位置に格納できる最大データ量は、呼び出し元によって value_len に指定されます。 tpkey_getinfo() が完了すると、value_len は実際に返されたデータ・サイズに設定されます。この場合、string 値の終了 NULL 値も含まれます。返されるバイト数が value_len より大きい場合、tpkey_getinfo() は異常終了し (TPELIMIT エラー・コードを返し)、value_len を必要な大きさに設定します。 引数 flags は使用されません。この引数は将来使用する予定であり、現在は必ずゼロを指定してください。 戻り値 異常終了すると、この関数は -1 を返し、tperrno を設定してエラー条件を示します。 エラー
関連項目
tpkey_close(3c)、tpkey_open(3c)、tpkey_setinfo(3c)
![]() |
![]() |
![]() |
![]() |
||
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |