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