使用 CryptCATAdminAddCatalog 安裝目錄檔案

安裝程式可以使用 CryptCATAdminAddCatalog 和其他 CryptCATAdminXxx 密碼編譯函式，以程式設計方式在系統元件和驅動程式資料庫中安裝 類別目錄檔案 。

安裝程式必須使用適用於 Windows 7 的 Microsoft Windows 軟體開發工具包 (SDK) ，並以下列方式 .NET Framework 4.0：

• 安裝程式的來源檔案必須包含下列標頭 (.h) 檔案：

  • Mscat.h，定義各種 CryptCATAdminXxx 函式的原型和結構。
  • Softpub.h，定義 CryptCATAdminXxx 函式所使用的各種數據結構和 GUID。

• 安裝程式必須連結至 Wintrust.lib。

若要使用這些 CryptCATAdminXxx 密碼編譯函式，安裝程式會執行下列動作：

1. 呼叫 CryptCATAdminAcquireContext 以取得目錄管理員內容的句柄。 應用程式會將 pgSubsystem 輸入參數設定為 GUID DRIVER_ACTION_VERIFY指標，以識別子系統。 此 GUID 定義於 Softpub.h 中。

2. 呼叫 CryptCATAdminAddCatalog ，將 目錄檔案 新增至系統元件和驅動程序資料庫。 安裝程式會提供在步驟 1 中取得之目錄系統管理員內容的句柄、目錄檔案完整路徑的指標，以及函式用來在資料庫中安裝目錄檔案複本之目錄檔名的指標。 函式會針對已加入至資料庫的目錄檔案，傳回目錄資訊內容的句柄。

3. 呼叫 CryptCATAdminReleaseCatalogContext ，以釋放目錄檔案目錄資訊內容的句柄。 安裝程式會將句柄提供給步驟 1 中取得的目錄系統管理員內容，以及步驟 2 中傳回之目錄資訊內容的句柄。

4. 呼叫 CryptCATAdminReleaseContext ，以釋放目錄系統管理員內容的句柄。 應用程式會將句柄提供給在步驟 1 中取得的目錄系統管理員內容。