CertAddStoreToCollection

CertAddStoreToCollection 関数は、コレクション証明書ストアに兄弟証明書ストアを追加する。

CertAddStoreToCollection hCollectionStore, hSiblingStore, dwUpdateFlags, dwPriority

hCollectionStore : [int] 証明書ストアのハンドル。
hSiblingStore : [int] コレクションストアに追加する兄弟ストアのハンドル。詳しくは備考を参照。
dwUpdateFlags : [int] コレクションストアの新しい兄弟ストアメンバーに対して、証明書、CRL、CTL を追加できるかを示す。追加を有効にするには、dwUpdateFlag に CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG を設定する。追加を無効にするには、dwUpdateFlag に 0 を設定する。
dwPriority : [int] コレクション内の新しいストアの優先順位レベルを設定する。0 が最下位の優先順位である。このパラメーターに 0 を渡すと、指定したストアはコレクション内の末尾に追加される。コレクション内のストアの優先順位レベルは、ストアを列挙する順序と、証明書、CRL、または CTL を取得する際のストアの検索順序を決定する。優先順位レベルは、新しい証明書、CRL、または CTL がコレクションのどのストアに追加されるかも決定する。詳しくは備考を参照。

(プラグイン / モジュール : crypt32.dll)

解説

CertAddStoreToCollection 関数は、コレクション証明書ストアに兄弟証明書ストアを追加する。

[戻り値]
関数が成功した場合、関数は 0 以外を返し、新しいストアがストアのコレクションに追加される。関数が失敗した場合は 0
を返し、ストアは追加されない。

[備考]
コレクションストアは単一ストアと同じ HCERTSTORE
ハンドルを持つため、証明書ストアに適用されるほぼすべての関数はコレクションストアにも適用される。列挙および検索処理は、コレクションストア内のすべてのストアにまたがって行われる。ただし、CertAddCertificateLinkToStore
など、ストアにリンクを追加する関数はコレクションストアでは使用できない。証明書、CRL、または CTL
がコレクションストアに追加されると、コレクション内の兄弟ストアのリストが優先順位順に検索され、追加を許可する最初のストアが選ばれる。追加は
CertAddStoreToCollection の呼び出しで CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG
を設定したときに有効になる。ストアに要素を追加する関数では、追加を許可するストアが成功を返さない場合、追加関数は通知なしで次のストアへ進む。コレクションストアとその兄弟ストアを
CertCloseStore で CERT_CLOSE_STORE_FORCE_FLAG
を指定して閉じる場合、兄弟ストアより先にコレクションストアを閉じなければならない。CERT_CLOSE_STORE_FORCE_FLAG
を使用しない場合、ストアはどの順序でも閉じてよい。

情報