共用方式為

CryptCATOpen 函式 (mscat.h)

  • 發行項

[ CryptCATOpen 函式可用於需求一節中指定的作業系統。 後續版本可能會變更或無法使用。]

CryptCATOpen函式會開啟目錄，並將內容控制碼傳回給開啟的目錄。

注意 某些舊版的 Wintrust.lib 不包含此函式的匯出資訊。 在此情況下，您必須使用 LoadLibrary 和 GetProcAddress 函式來動態連結至 Wintrust.dll。
 

語法

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

參數

[in] pwszFileName

類別目錄檔案名之 Null 終止字串的指標。

[in] fdwOpenFlags

零，若要開啟現有的目錄檔案，或下列一或多個值的位元組合。

值 意義
CRYPTCAT_OPEN_ALWAYS
 如果檔案存在，請開啟檔案，或視需要建立新的檔案。
CRYPTCAT_OPEN_CREATENEW
 系統會建立新的目錄檔案。 如果先前建立的檔案存在，則會覆寫它。
CRYPTCAT_OPEN_EXISTING
 已開啟現有的目錄檔案。
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
 已開啟現有的目錄檔案。 在 SPC_INDIRECT_DATA 中排除頁面雜湊。
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
 已開啟現有的目錄檔案。 在SPC_INDIRECT_DATA中包含頁面雜湊。 如果同時設定，上述CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES會優先。
CRYPTCAT_OPEN_VERIFYSIGHASH
 已開啟現有的目錄檔案。 驗證簽章，而不是憑證。
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
 已開啟現有的目錄檔案。 CryptMsgDecode 沒有內容。
CRYPTCAT_OPEN_SORTED
 已開啟現有的目錄檔案。 CertCreateCoNtext (CERT_CREATE_CONTEXT_SORTED_FLAG) 。

[in] hProv

密碼編譯服務提供者的控制碼， (CSP) 。

[in] dwPublicVersion

檔案的版本。 這可以是下列其中一個值。

值 意義
CRYPTCAT_VERSION_1
0x100
 第 1 版檔案格式。
CRYPTCAT_VERSION_2
0x200
 第 2 版檔案格式。

Windows 8 和 Windows Server 2012： 開始支援此值。

[in] dwEncodingType

用於檔案的編碼類型。 如果此值為 0，則編碼類型會設定為 PKCS_7_ASN_ENCODING |X509_ASN_ENCODING。

傳回值

成功時，此函式會傳回開啟目錄的控制碼。 當您完成使用控制碼時，請呼叫 CryptCATClose 函式來關閉它。 CryptCATOpen函式會在失敗時傳回INVALID_HANDLE_VALUE。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 mscat.h
程式庫 Wintrust.lib
Dll Wintrust.dll

另請參閱

CryptCATClose