структура 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 |