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 |