CertAddCertificateLinkToStore

証明書ストア内に、別のストアにある証明書コンテキストへのリンクを追加する。

CertAddCertificateLinkToStore hCertStore, pCertContext, dwAddDisposition, ppStoreContext

hCertStore : [int] リンクを追加する証明書ストアのハンドル。
pCertContext : [var] リンク対象の CERT_CONTEXT 構造体へのポインター。
dwAddDisposition : [int] 一致する証明書または一致する証明書へのリンクが既にストアに存在する場合の動作を指定する。現在定義されている配置値とその用途は次のとおり。
ppStoreContext : [var] 作成されたリンクのコピーへのポインターへのポインター。リンクのコピーが不要な場合、ppStoreContext に NULL を指定できる。リンクのコピーが作成された場合、そのコピーは CertFreeCertificateContext 関数で解放しなければならない。

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

解説

証明書ストア内に、別のストアにある証明書コンテキストへのリンクを追加する。

[戻り値]
関数が成功した場合、戻り値は TRUE。関数が失敗した場合、戻り値は FALSE。拡張エラー情報は GetLastError
を呼び出して取得する。想定されるエラーコードを以下に示す。
（以下省略）

[備考]

リンクは元の証明書コンテキストへのアクセスを提供するため、リンクされた証明書コンテキストで拡張プロパティを設定すると、元の証明書、および同じ証明書への他のすべてのリンクにおけるその拡張プロパティも変更される。コレクションとして開かれたストアにはリンクを追加できない。コレクションとして開かれたストアには、CertOpenSystemStore
または CertOpenStore に CERT_STORE_PROV_SYSTEM あるいは
CERT_STORE_PROV_COLLECTION を指定して開かれたすべてのストアが含まれる。詳しくは
CertAddStoreToCollection を参照。リンクを使用している場合で、CertCloseStore を
CERT_CLOSE_STORE_FORCE_FLAG
付きで呼び出すときは、元のコンテキストを含むストアを閉じる前に、リンクを使用しているストアを閉じなければならない。CERT_CLOSE_STORE_FORCE_FLAG
を使用しない場合、2 つのストアはどちらの順序でも閉じてよい。証明書ストアから証明書コンテキストリンクを削除するには
CertDeleteCertificateFromStore 関数を使用する。

情報