tpkey_setinfo(3c)


	BEA ホーム \| イベント \| ソリューション \| パートナ \| 製品 \| サービス \| ダウンロード \| ディベロッパ・センタ \| WebSUPPORT
	e-docs \| サイトマップ \| 検索 \| PDF版 \| お問い合わせ \| 用語集

Tuxedoホーム \| BEA Tuxedo C リファレンス \| 先頭へ \| 前へ \| 次へ \| 目次

tpkey_setinfo(3c)

名前

tpkey_setinfo()-キー・ハンドルに関連するオプション属性パラメータの設定

形式

#include <atmi.h>
int tpkey_setinfo(TPKEY hKey, char *attribute_name, void *value,
long value_len, long flags)

機能説明

tpkey_setinfo() は、キー・ハンドルのオプション属性パラメータを設定します。キー・ハンドルは指定されたプリンシパルのキーと、それに関連する情報を表します。

情報が修正されるキーは、hKey 入力パラメータで識別されます。情報が修正される属性は、attribute_name 入力パラメータで識別されます。一部の暗号サービス・プロバイダに固有の属性もありますが、tpkey_getinfo(3c) リファレンス・ページに示す基本的属性は、すべてのプロバイダがサポートしています。

attribute_name パラメータに関連付けられた情報は、value によって示されるメモリ位置に格納されます。value のデータ内容が自己記述型の場合、value_len は無視されます (0 でかまいません)。それ以外の場合、value_len には value 内のデータの長さが格納されている必要があります。

引数 flags は使用されません。この引数は将来の用途のために予約されており、0 (ゼロ) に設定されます。

戻り値

異常終了すると、この関数は -1 を返し、tperrno() を設定してエラー条件を示します。

エラー

[TPEINVAL]

無効な引数が指定されました。たとえば、hKey が有効なキーでない場合やattribute_name が読み取り専用の値を参照している場合などです。

[TPELIMIT]

指定した value が大きすぎます。

[TPESYSTEM]

エラーが発生しました。詳細については、システム・エラー・ログ・ファイルを参照してください。

[TPENOENT]

要求された属性を、キーの暗号サービス・プロバイダが認識できません。