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

Статья
08/24/2023

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

Функция CryptCATGetAttrInfo извлекает сведения об атрибуте члена каталога.

Синтаксис

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

Параметры

[in] hCatalog

Дескриптор каталога, содержащий элемент, для которого требуется получить сведения об атрибуте. Этот дескриптор получается путем вызова функции CryptCATOpen . Этот параметр является обязательным и не может иметь значение NULL.

[in] pCatMember

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

[in] pwszReferenceTag

Указатель на строку Юникода, завершающуюся null, которая содержит имя атрибута, для которого требуется получить сведения. Этот параметр является обязательным и не может иметь значение NULL.

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

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

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

Если эта функция возвращает значение NULL, дополнительные сведения об ошибке можно получить, вызвав функцию GetLastError . GetLastError вернет один из следующих кодов ошибок.

Код возврата	Описание
CRYPT_E_NOT_FOUND	Не удалось найти элемент или атрибут .
ERROR_INVALID_PARAMETER	Один или несколько параметров являются недопустимыми.

Требования


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

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

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATОткрыть

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