|
|
tpkey_getinfo(3c)
名前
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 値の終了ヌル値も含まれます。返されるバイト数が value_len より大きい場合、tpkey_getinfo() は異常終了し (TPELIMIT エラー・コードを返し)、value_len を必要な大きさに設定します。 flags は将来使用する予定であり、現在は必ずゼロを指定してください。 戻り値 異常終了すると、この関数は -1 を返し、tperrno() を設定してエラー条件を示します。 エラー
関連項目
tpkey_close(3c)、tpkey_open(3c)、tpkey_setinfo(3c)
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|