Функция 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

Указатель на структуру CRYPTCATATTRIBUTE для атрибута каталога в CDF, на который указывает pCDF.

[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
Header mscat.h
DLL Wintrust.dll

См. также раздел

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat