共用方式為

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

另請參閱

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext