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

Требования

См. также

CRYPTCATATTRIBUTE

CRYPTCATCDF

MakeCat