CryptCATAdminAddCatalog 函式 (mscat.h)
[ CryptCATAdminAddCatalog 函式可用於需求一節中指定的作業系統。 它可能會在後續版本中改變或無法使用。]
CryptCATAdminAddCatalog 函式會將目錄新增至目錄資料庫。 目錄資料庫是一個索引，可將檔案哈希與包含它們的目錄產生關聯。 它用來在驗證檔案簽章時加速識別目錄。 此函式是以程序設計方式將目錄新增至 Windows 目錄資料庫的唯一支援方式。 函式沒有相關聯的匯入連結庫。 您必須使用 LoadLibrary 和 GetProcAddress 函式，以動態方式連結至 Wintrust.dll。
語法
HCATINFO CryptCATAdminAddCatalog(
[in] HCATADMIN hCatAdmin,
[in] PWSTR pwszCatalogFile,
[in] PWSTR pwszSelectBaseName,
[in] DWORD dwFlags
);
參數
[in] hCatAdmin
處理先前由 CryptCATAdminAcquireContext 函式指派的 。
[in] pwszCatalogFile
要加入之目錄完整路徑之 Null 終止字串的指標。
[in] pwszSelectBaseName
儲存目錄名稱之 Null 終止字串的指標。 如果參數為 NULL，則會為目錄產生唯一的名稱。
[in] dwFlags
如果指定CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) 旗标，呼叫中指定的目錄將會硬式連結至 ，而不是複製。 硬式連結而不是複製目錄可減少 Windows 所需的磁碟空間量。
傳回值
如果函式成功，則傳回值是目錄信息內容的句柄。 如果函式失敗，則傳回值為 NULL。 使用傳回的句柄之後，請呼叫 CryptCATAdminReleaseCatalogContext 函式來釋放它。
如需擴充錯誤資訊，請呼叫 GetLastError 函式。 如需作業系統所提供的錯誤碼完整清單，請參閱 系統錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mscat.h |
| 程式庫 | Wintrust.lib |
| Dll | Wintrust.dll |