EN JA
hx509 certificate store functions(3)
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_store (hx509_context context, hx509_certs certs, int flags, hx509_lock lock)
 
void hx509_certs_free (hx509_certs *certs)
 
int hx509_certs_start_seq (hx509_context context, hx509_certs certs, hx509_cursor *cursor)
 
int hx509_certs_next_cert (hx509_context context, hx509_certs certs, hx509_cursor cursor, hx509_cert *cert)
 
int hx509_certs_end_seq (hx509_context context, hx509_certs certs, hx509_cursor cursor)
 
int hx509_certs_iter_f (hx509_context context, hx509_certs certs, int(*func)(hx509_context, void *, hx509_cert), void *ctx)
 
int hx509_ci_print_names (hx509_context context, void *ctx, hx509_cert c)
 
int hx509_certs_add (hx509_context context, hx509_certs certs, hx509_cert cert)
 
int hx509_certs_find (hx509_context context, hx509_certs certs, const hx509_query *q, hx509_cert *r)
 
int hx509_certs_filter (hx509_context context, hx509_certs certs, const hx509_query *q, hx509_certs *result)
 
int hx509_certs_merge (hx509_context context, hx509_certs to, hx509_certs from)
 
int hx509_certs_append (hx509_context context, hx509_certs to, hx509_lock lock, const char *name)
 
int hx509_get_one_cert (hx509_context context, hx509_certs certs, hx509_cert *c)
 
int hx509_certs_info (hx509_context context, hx509_certs certs, int(*func)(void *, const char *), void *ctx)
 

詳細説明

説明と実行例については、 証明書格納操作を参照してください。

関数説明

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