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

  • Статья

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

Функция CryptCATEnumerateMember перечисляет элементы каталога.

Синтаксис

CRYPTCATMEMBER * CryptCATEnumerateMember(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pPrevMember
);

Параметры

[in] hCatalog

Дескриптор каталога, содержащего элементы для перечисления. Это значение не может иметь значение NULL.

[in] pPrevMember

Указатель на структуру CRYPTCATMEMBER , которая определяет, какой член каталога был извлечен в последний раз. Если этот параметр имеет значение NULL, эта функция извлекает первый член каталога.

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

Эта функция возвращает указатель на структуру CRYPTCATMEMBER , представляющую следующий элемент каталога. Если в каталоге больше нет элементов для перечисления, эта функция возвращает значение NULL.

Комментарии

Не освобождайте возвращаемый указатель или элементы, на которые указывает возвращенный указатель.

Примеры

В следующем примере псевдокода показано, как использовать эту функцию для перечисления всех членов каталога.

CRYPTCATMEMBER *pMember = NULL;

for(pMember = CryptCATEnumerateMember(hCatalog, pMember); 
    NULL != pMember; 
    pMember = CryptCATEnumerateMember(hCatalog, pMember))
{
   // Use the catalog member.
}

Требования

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

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

CRYPTCATMEMBER