セクション 3c

ドキュメントのダウンロード

サイトマップ

用語集

検索

e-docs > Tuxedo > Tuxedo C リファレンス > セクション 3c - C 関数

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]

要求された属性は、キーの暗号サービス・プロバイダによって認識されません。