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 |