| hx509 certificate store functions(3) | Heimdalx509library | hx509 certificate store functions(3) |
名称
hx509 証明書格納関数-関数
int hx509_certs_init (hx509_context context, const char *name, int flags, hx509_lock lock, hx509_certs *certs)
詳細説明
説明と実行例については、 証明書格納操作を参照してください。関数説明
int hx509_certs_add (hx509_context context, hx509_certs certs, hx509_cert cert)
証明書格納に証明書を追加します。受信していキーセット certs は、cert の参照カウンタ増加するか、またはディープコピーを行う、いずれかの方法、呼び出し側が cert 自体を解放する必要があります。
パラメータ:
context hx509 コンテキスト。
certs 証明書を追加する証明書格納。
cert 追加する証明書。
返り値:
hx509 エラーコードを返します。
int hx509_certs_append (hx509_context context, hx509_certs to, hx509_lock lock, const char * name)
hx509_certs_merge() と同しですが、ロックとソースから記述するための名前を使用します。パラメータ:
context hx509 コンテキスト。
to マージする格納。
lock 証明書格納をアンロックするロック、password/certifictes/prompt ロック以外を選択するために NULL を使用します、 (
証明書と暗号化されたデータをロックして、アンロックするを参照)。
name ソース格納の名前。
返り値:
hx509 エラーコードを返します。
int hx509_certs_end_seq (hx509_context context, hx509_certs certs, hx509_cursor cursor)
証明書の繰り返しを終ります。パラメータ:
context hx509 コンテキスト。
certs 繰り返す証明書格納。
cursor 解放されて、進行の経過をを追うカーソル。
返り値:
hx509 エラーコードを返します。
int hx509_certs_filter (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_certs * result)
問い合わせと一致する証明書をフィルタリングする。パラメータ:
context hx509 コンテキスト。
certs 検索する証明書格納。
q
hx509 問い合わせ関数関数で割り付けられた問い合わせ。
result フィルタリングされた証明書格納、呼び出し側は、
hx509_certs_free() で解放しなければなりません。
返り値:
hx509 エラーコードを返します。
certs の証明書が問い合わせと一致しなかったなら、HX509_CERT_NOT_FOUND を返します。
int hx509_certs_find (hx509_context context, hx509_certs certs, const hx509_query * q, hx509_cert * r)
証明書が問い合わせと一致しているかを調べます。パラメータ:
context hx509 コンテキスト。
certs 検索する証明書格納。
q
hx509 問い合わせ関数関数で割り付けられた問い合わせ。
r 証明書 (またはエラーで NULL) を返します、
hx509_cert_free() で解放されるべきです。
返り値:
hx509 エラーコードを返します。
certs の証明書が問い合わせと一致しなかったなら、HX509_CERT_NOT_FOUND を返します。
void hx509_certs_free (hx509_certs * certs)
証明書格納を解放します。パラメータ:
certs 解放する証明書格納。
int hx509_certs_info (hx509_context context, hx509_certs certs, int(*)(void *, const char *) func, void * ctx)
証明書格納に関するいくつかの情報を印刷します。パラメータ:
context hx509 コンテキスト。
certs 情報を印刷するための証明書格納。
func 情報の各行を取得する関数、NULL が使用されるなら、データは、ctx で渡されるべき FILE 記述しで印刷され、 ctx も NULL であるなら、stdout が使用されます。
ctx func へのパラメータ。
返り値:
hx509 エラーコードを返します。
int hx509_certs_init (hx509_context context, const char * name, int flags, hx509_lock lock, hx509_certs * certs)
新しい hx509 証明書格納をオープンして作成します。パラメータ:
context hx509 コンテキスト。
name 格納の名前、形式は、TYPE:type-specific-string で、 NULL が使用されるなら、MEMORY 格納が使用されます。
flags フラグのリストは、次の通りです:
- •
- HX509_CERTS_CREATE 特定の TYPE の新しい keystore を作成します。
- •
- HX509_CERTS_UNPROTECT_ALL 秘密鍵を抽出することに失敗するなら、失敗。
lock 証明書格納をアンロックするロック、password/certifictes/prompt ロック以外を選択するために NULL を使用します、 ( 証明書と暗号化されたデータをロックして、アンロックするを参照)。
certs ポインタを返します、 hx509_certs_free() で解放します。
int hx509_certs_iter_f (hx509_context context, hx509_certs certs, int(*)(hx509_context, void *, hx509_cert) func, void * ctx)
keystore のすべての証明書を繰り返し、それらのためのそれぞれの関数を呼び出します。パラメータ:
context hx509 コンテキスト。
certs 繰り返す証明書格納。
func 各証明書を呼び出す関数。関数は、繰り返しを中止するために 0 以外を返すべきです、その値は、
hx509_certs_iter_f() の呼び出し側に戻されます。
ctx 関数に渡されるコンテキスト変数。
返り値:
hx509 エラーコードを返します。
int hx509_certs_merge (hx509_context context, hx509_certs to, hx509_certs from)
別のものへ証明書格納をマージします。 from 格納は、変更されないままとされます。パラメータ:
context hx509 コンテキスト。
to マージする格納。
from オブジェクトをコピーする格納。
返り値:
hx509 エラーコードを返します。
int hx509_certs_next_cert (hx509_context context, hx509_certs certs, hx509_cursor cursor, hx509_cert * cert)
カーソルによって指された証明書 keystore から次の証明書を取得します。パラメータ:
context hx509 コンテキスト。
certs 繰り返す証明書格納。
cursor 進行の経過を追うカーソル。
cert 格納の次の証明書を返します、格納が、これ以上の証明書を含んでいないなら、NULL を返します。
hx509_cert_free() で解放します。
返り値:
hx509 エラーコードを返します。
int hx509_certs_start_seq (hx509_context context, hx509_certs certs, hx509_cursor * cursor)
統合を開始します。パラメータ:
context hx509 コンテキスト。
certs 繰り返す証明書格納。
cursor 進行の経過を追うカーソル、
hx509_certs_end_seq() で解放します。
返り値:
hx509 エラーコードを返します。証明書格納が繰り返し操作をサポートしていないなら、 HX509_UNSUPPORTED_OPERATION が返されます。
int hx509_certs_store (hx509_context context, hx509_certs certs, int flags, hx509_lock lock)
静的な記憶域に証明書格納を書き込みます。パラメータ:
context hx509 コンテキスト。
certs 格納する証明書格納。
flags 現在未使用、0 を使用します。
lock 証明書格納をアンロックするロック、password/certifictes/prompt ロック以外を選択するために NULL を使用します、 (
証明書と暗号化されたデータをロックして、アンロックするを参照)。
返り値:
hx509 エラーコードを返します。証明書格納が繰り返し操作をサポートしていないなら、 HX509_UNSUPPORTED_OPERATION が返されます。
int hx509_ci_print_names (hx509_context context, void * ctx, hx509_cert c)
keystore のすべての証明書を繰り返し、それらのためのそれぞれの関数を呼び出します。パラメータ:
context hx509 コンテキスト。
certs 繰り返す証明書格納。
func 各証明書を呼び出す関数。関数は、繰り返しを中止するために 0 以外を返すべきです、その値は、hx509_certs_iter() の呼び出し側に戻されます。
返り値:
hx509 エラーコードを返します。関数の引数として
hx509_certs_iter_f() に使用する関数、
hx509_certs_iter_f() への ctx 変数は、FILE ファイル記述子であるべきです。
パラメータ:
context hx509 コンテキスト。
ctx
hx509_certs_iter_f() によって使用されます。
c 証明書。
返り値:
hx509 エラーコードを返します。
int hx509_get_one_cert (hx509_context context, hx509_certs certs, hx509_cert * c)
証明書格納から 1 つのランダムな証明書を取得します。パラメータ:
context hx509 コンテキスト。
certs 証明書を取得する証明書格納。
c 証明書を返します、
hx509_cert_free() で解放されるべきです。
返り値:
hx509 エラーコードを返します。
| 11 Jan 2012 | Version 1.5.2 |