インストール プログラムは、CryptCATAdminAddCatalog およびその他の CryptCATAdminXxx 暗号化関数を使用して、システム コンポーネントとドライバー データベースに カタログ ファイルをプログラムでインストールできます。
インストール プログラムでは、次の方法で Windows 7 および .NET Framework 4.0 用の Microsoft Windows ソフトウェア開発キット (SDK) を使用する必要があります。
インストール プログラムのソース ファイルには、次のヘッダー (.h) ファイルを含める必要があります。
- Mscat.h。さまざまな CryptCATAdminXxx 関数のプロトタイプと構造を定義します。
- Softpub.h。CryptCATAdminXxx 関数で使用されるさまざまなデータ構造と GUID を定義します。
インストール プログラムは、Wintrust.libにリンクされている必要があります。
これらの CryptCATAdminXxx 暗号化機能を使用するには、インストール プログラムで次の処理が行われます。
CryptCATAdminAcquireContext を呼び出して、カタログ管理者コンテキストへのハンドルを取得します。 アプリケーションは、pgSubsystem 入力パラメーターを GUID DRIVER_ACTION_VERIFYへのポインターに設定することで、サブシステムを識別します。 この GUID は、Softpub.hで定義されています。
CryptCATAdminAddCatalog 呼び出して、システム コンポーネントとドライバー データベースに カタログ ファイルを追加します。 インストール プログラムは、手順 1 で取得したカタログ管理者コンテキストへのハンドル、カタログ ファイルの完全修飾パスへのポインター、およびカタログ ファイルのコピーをデータベースにインストールするために関数が使用するカタログ ファイルの名前へのポインターを提供します。 この関数は、データベースに追加されたカタログ ファイルのカタログ情報コンテキストへのハンドルを返します。
カタログ ファイルのカタログ情報コンテキストに対するハンドルを解放するために、CryptCATAdminReleaseCatalogContext を呼び出します。 インストール プログラムは、手順 1 で取得したカタログ管理者コンテキストと、手順 2 で返されたカタログ情報コンテキストへのハンドルを提供します。
カタログ管理者コンテキストのハンドルを解放するために、CryptCATAdminReleaseContext を呼び出します。 アプリケーションは、手順 1 で取得したカタログ管理者コンテキストにハンドルを提供します。