CryptCATCDFEnumCatAttributes 函数 （mscat.h）

[ CryptCATCDFEnumCatAttributes 函数可用于“要求”部分中指定的作系统。 在后续版本中可能会更改或不可用。

CryptCATCDFEnumCatAttributes 函数枚举目录定义文件 （CDF） 的 CatalogHeader 节中的目录级属性。 MakeCat 调用 CryptCATCDFEnumCatAttributes。

Syntax

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);

要求

另请参阅

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat