Функция CryptCATCDFEnumMembersByCDFTagEx

Статья
06/13/2023

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

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

Примечание

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

Синтаксис

LPWSTR WINAPI CryptCATCDFEnumMembersByCDFTagEx(
  _In_    CRYPTCATCDF                  *pCDF,
  _Inout_ LPWSTR                       pwszPrevCDFTag,
  _In_    PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError,
  _In_    CRYPTCATMEMBER               **ppMember,
  _In_    BOOL                         fContinueOnError,
  _In_    LPVOID                       pvReserved
);

Параметры

pCDF [in]: Указатель на структуру CRYPTCATCDF .
pwszPrevCDFTag [in, out]: Указатель на строку, завершающуюся null, которая идентифицирует член файла каталога.
pfnParseError [in]: Указатель на определяемую пользователем функцию для обработки ошибок синтаксического анализа файлов.
ppMember [in]: Указатель на структуру CRYPTCATMEMBER , содержащую сведения об члене файла.
fContinueOnError [in]: Значение типа , указывающее, следует ли хранить в памяти ссылку на последний перечислимый элемент.
pvReserved [in]: Этот параметр зарезервирован; не использовать его.

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

После успешного выполнения эта функция возвращает указатель на строку, завершающуюся null, которая идентифицирует член файла в разделе CatalogFiles CDF. Функция CryptCATCDFEnumMembersByCDFTagEx возвращает указатель NULL в случае сбоя.

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

Примеры

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

    CRYPTCATMEMBER      *pMember;
    LPWSTR              pwszMemberTag;
    CRYPTCATCDF         *pCDF;

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

    pMember = NULL;
    pwszMemberTag = NULL;

    while (pwszMemberTag = CryptCATCDFEnumMembersByCDFTagEx(pCDF,
                                                            pwszMemberTag,
                                                            NULL,
                                                            &pMember,
                                                            FALSE,
                                                            NULL))
    {
        //do something with pwszMemberTag and pMember
    }

    CryptCATCDFClose(pCDF);

Требования

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

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

MakeCat
CRYPTCATCDF
CRYPTCATMEMBER
GetProcAddress
LoadLibrary