Функция CryptCATCDFEnumAttributesWithCDFTag

Статья
06/13/2023

[Функция CryptCATCDFEnumAttributesWithCDFTag доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Функция CryptCATCDFEnumAttributesWithCDFTag перечисляет атрибуты файлов-членов в разделе CatalogFiles файла определения каталога (CDF). CryptCATCDFEnumAttributesWithCDFTag вызывается makeCat.

Примечание

У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mssign32.dll.

Синтаксис

CRYPTCATATTRIBUTE* WINAPI CryptCATCDFEnumAttributesWithCDFTag(
  _In_ CRYPTCATCDF                  *pCDF,
  _In_ LPWSTR                       pwszMemberTag,
  _In_ CRYPTCATMEMBER               *pMember,
  _In_ CRYPTCATATTRIBUTE            *pPrevAttr,
  _In_ PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);

Параметры

pCDF [in]: Указатель на структуру CRYPTCATCDF .
pwszMemberTag [in]: Указатель на строку, завершающуюся значением NULL, идентифицирующее элемент файла каталога.
pMember [in]: Указатель на структуру CRYPTCATMEMBER , содержащую сведения об элементе.
pPrevAttr [in]: Указатель на структуру CRYPTCATATTRIBUTE для атрибута члена файла в CDF, на который указывает pCDF.
pfnParseError [in]: Указатель на определяемую пользователем функцию для обработки ошибок синтаксического анализа файлов.

Возвращаемое значение

При успешном выполнении эта функция возвращает указатель на структуру CRYPTCATATTRIBUTE . Функция CryptCATCDFEnumAttributesWithCDFTag возвращает указатель NULL в случае сбоя.

Обычно эта функция вызывается в цикле для перечисления всех атрибутов-членов файла каталога в CDF. Перед входом в цикл задайте для pPrevAttrзначение NULL. Функция возвращает указатель на первый атрибут. Присвойте pPrevAttr возвращаемое значение функции для последующих итераций цикла.

Примеры

В следующем примере показана правильная последовательность назначений для параметра pPrevAttr (pAttr).

    CRYPTCATATTRIBUTE   *pAttr;
    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

    pCDF = CryptCATCDFOpen(L"myCDF", NULL);
    

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        pAttr = NULL;

        while (pAttr = CryptCATCDFEnumAttributesWithCDFTag(pCDF,
                                                           pwszMemberTag,
                                                           pMember,
                                                           pAttr,
                                                           DisplayParseError))
        {
            //do something with pAttr
        }

    }

    CryptCATCDFClose(pCDF);

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
DLL	Wintrust.dll

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

MakeCat
CRYPTCATATTRIBUTE
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary

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