Функция CryptCATCDFEnumCatAttributes (mscat.h)

Статья
08/24/2023

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

Поделиться через