Функция CertEnumCertificateContextProperties (wincrypt.h)

  • Статья

Функция CertEnumCertificateContextProperties извлекает первое или следующее расширенное свойство, связанное с контекстом сертификата. Эта функция, используемая в цикле, может последовательно извлекать все расширенные свойства, связанные с контекстом сертификата.

Синтаксис

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

Параметры

[in] pCertContext

Указатель на структуру CERT_CONTEXT сертификата, содержащего перечисляемые свойства.

[in] dwPropId

Номер свойства последнего перечисленного свойства. Чтобы получить первое свойство, dwPropId равен нулю. Для получения последующих свойств параметру dwPropId присваивается номер свойства, возвращенный последним вызовом функции. Чтобы перечислить все свойства, вызовы функций продолжаются до тех пор, пока функция не вернет ноль.

Приложения могут вызывать CertGetCertificateContextProperty с dwPropId , возвращенным этой функцией, для получения данных этого свойства.

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

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

Комментарии

свойства CERT_KEY_PROV_HANDLE_PROP_ID и CERT_KEY_SPEC_PROP_ID хранятся как члены свойства CERT_KEY_CONTEXT_PROP_ID. Они не перечисляются по отдельности.

Примеры

См . пример программы C. Перечисление сертификатов в Магазине.

Требования

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

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

CERT_CONTEXT

CertGetCertificateContextProperty

Расширенные функции свойств