CryptCATCDFEnumCatAttributes 函式 (mscat.h)
[ CryptCATCDFEnumCatAttributes 函式可用於需求一節中指定的操作系統。 它可能會在後續版本中改變或無法使用。]
CryptCATCDFEnumCatAttributes 函式會列舉目錄定義檔之 CatalogHeader 區段中的目錄層級屬性, (CDF) 。 CryptCATCDFEnumCatAttributes 是由 MakeCat 呼叫。
語法
CRYPTCATATTRIBUTE * CryptCATCDFEnumCatAttributes(
[in] CRYPTCATCDF *pCDF,
[in] CRYPTCATATTRIBUTE *pPrevAttr,
[in] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
參數
[in] pCDF
CRYPTCATCDF 結構的指標。
[in] pPrevAttr
PCDF 所指向之 CDF 中目錄屬性的 CRYPTCATATTRIBUTE 結構的指標。
[in] pfnParseError
使用者定義函式的指標,可處理檔案剖析錯誤。
傳回值
成功時,此函式會傳回 CRYPTCATATTRIBUTE 結構的指標。 CryptCATCDFEnumCatAttributes 函式會在失敗時傳回 NULL 指標。
備註
您通常會在迴圈中呼叫此函式,以列舉CDF中的所有目錄標頭屬性。 進入迴圈之前,請將 pPrevAttr 設定為 NULL。 函式會傳回第一個屬性的指標。 將 pPrevAttr 設定為函式的傳回值,以供迴圈的後續反覆專案使用。
範例
下列範例顯示 pPrevAttr 參數 () pAttr
的正確指派順序。
CRYPTCATCDF *pCDF;
CRYPTCATATTRIBUTE *pAttr;
pCDF = CryptCATCDFOpen(L"myCDF", NULL);
pAttr = NULL;
while (pAttr = CryptCATCDFEnumCatAttributes(pCDF, pAttr, NULL))
{
//do something with pAttr
}
CryptCATCDFClose(pCDF);
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mscat.h |
Dll | Wintrust.dll |