структура CTL_VERIFY_USAGE_STATUS (wincrypt.h)

  • Статья

Структура CTL_VERIFY_USAGE_STATUS содержит сведения о списке доверия сертификатов (CTL), возвращаемом CertVerifyCTLUsage.

Синтаксис

typedef struct _CTL_VERIFY_USAGE_STATUS {
  DWORD          cbSize;
  DWORD          dwError;
  DWORD          dwFlags;
  PCCTL_CONTEXT  *ppCtl;
  DWORD          dwCtlEntryIndex;
  PCCERT_CONTEXT *ppSigner;
  DWORD          dwSignerIndex;
} CTL_VERIFY_USAGE_STATUS, *PCTL_VERIFY_USAGE_STATUS;

Члены

cbSize

Размер структуры (в байтах). Приложение, вызывающее CertVerifyCTLUsage, задает этот параметр. Если cbSize не больше или не равен требуемому размеру структуры, CertVerifyCTLUsage возвращает значение FALSE , а GetLastError возвращает E_INVALIDARG.

dwError

Состояние ошибки, если таковое есть, возвращенное вызовом CertVerifyCTLUsage. Список возможных значений ошибок см. в разделе Возвращаемые значения статьи CertVerifyCTLUsage.

dwFlags

Если возвращается CERT_VERIFY_UPDATED_CTL_FLAG , CertVerifyCTLUsage обновляет CTL, время которого больше не является действительным, с новым, допустимым по времени CTL.

ppCtl

Указатель на указатель на контекст CTL, содержащий соответствующий субъект. Вызывающее приложение может задать для этого указателя значение NULL , чтобы указать, что объект CTL, содержащий тему, не возвращается.

Если значение ppCtl не равно NULL, вызывающее приложение должно освободить возвращаемый контекст с помощью CertFreeCTLContext.

dwCtlEntryIndex

Возвращает расположение массива записи соответствующего субъекта в массиве CTL.

ppSigner

Указатель на указатель на контекст сертификата подписывателя CTL. Вызывающее приложение может присвоить этому указателю значение NULL , указывающее, что сертификат подписывателя CTL не возвращается.

Если значение ppSigner не равно NULL, вызывающее приложение должно освободить возвращаемый контекст с помощью CertFreeCTLContext.

dwSignerIndex

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

Комментарии

Вызывающее приложение должно инициализировать члены dwError, dwFlags, dwCtlEntryIndex и dwSignerIndex до нуля.

Требования

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

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

CERT_CONTEXT

CTL_CONTEXT

CertVerifyCTLUsage