CertAddCTLLinkToStore

CertAddCTLLinkToStore 関数は、あるストア内に、別のストアにある証明書信頼リスト (CTL) コンテキストへのリンクを追加する。CTL コンテキストの複製を作成して追加する代わりに、元の CTL コンテキストへのリンクを追加する。

CertAddCTLLinkToStore hCertStore, pCtlContext, dwAddDisposition, ppStoreContext

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

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

解説

CertAddCTLLinkToStore 関数は、あるストア内に、別のストアにある証明書信頼リスト (CTL)
コンテキストへのリンクを追加する。CTL コンテキストの複製を作成して追加する代わりに、元の CTL コンテキストへのリンクを追加する。

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

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

情報