CryptCATCDFOpen 函式 (mscat.h)

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

CRYPTCATCDF 結構。 CryptCATCDFOpen 是由 MakeCat呼叫。

語法

CRYPTCATCDF * CryptCATCDFOpen(
  [in]           LPWSTR                       pwszFilePath,
  [in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

參數

[in] pwszFilePath

Null 終止字串的指標，其中包含要開啟之CDF檔案的路徑。

[in, optional] pfnParseError

使用者定義函式的指標，可處理檔案剖析錯誤。

傳回值

成功時，此函式會傳回新建立 CRYPTCATCDF 結構的指標。 CryptCATCDFOpen 函式會在失敗時傳回NULL指標。

備註

CryptCATCDFOpen 函式會針對CDF CatalogHeader 區段中的指定條件使用下列預設值。

CatalogHeader 條件	預設值
未指定 [名稱 ] 值。	pwszFilePath 中的檔名會用於目錄 (.cat) 输出档。
未指定 PublicVersion 值。	0x00000001
未指定 EncodingType 值。	PKCS_7_ASN_ENCODING或X509_ASN_ENCODING (0x00010001)

 

下列動作是由 CryptCATCDFOpen 函式針對指定的錯誤狀況執行。

錯誤狀況	執行的動作
CDF 中找不到 CatalogHeader 或 Name 卷標。	如果呼叫端指定， CryptCATCDFOpen 函式會呼叫 pfnParseError 所指定的函式，並傳回 NULL 指標。
CryptCATCDFOpen 函式會呼叫 CryptCATOpen 函式，以取得目錄的句柄 (.cat) 输出档案，但它會取得無效或 NULL 句柄。	呼叫 CryptCATCDFClose 函式，並傳回 NULL 指標。

 

目錄分支的其他 OID	定義
szOID_CATALOG_LIST_MEMBER_V2	1.3.6.1.4.1.311.12.1.3
CAT_MEMBERINFO2_OBJID	1.3.6.1.4.1.311.12.2.3

 

Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 其他目錄 OID 無法使用。

規格需求

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

另請參閱

CRYPTCATCDF

CryptCATCDFClose

CryptCATOpen

MakeCat