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

另请参阅

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat