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


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

Функция CertCreateCRLContext создает контекстсписка отзыва сертификатов (CRL) из закодированного списка отзыва сертификатов. Созданный контекст не сохраняется в хранилище сертификатов. Он создает копию закодированного списка отзыва сертификатов в созданном контексте.

Синтаксис

PCCRL_CONTEXT CertCreateCRLContext(
  [in] DWORD      dwCertEncodingType,
  [in] const BYTE *pbCrlEncoded,
  [in] DWORD      cbCrlEncoded
);

Параметры

[in] dwCertEncodingType

Указывает тип используемой кодировки. Всегда допустимо указывать типы кодирования сертификатов и сообщений, объединяя их с побитовой операцией ИЛИ , как показано в следующем примере:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING в настоящее время определены следующие типы кодирования:

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbCrlEncoded

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

[in] cbCrlEncoded

Размер буфера pbCrlEncoded (в байтах).

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

Если функция выполняется успешно, возвращаемое значение является указателем на CRL_CONTEXT только для чтения.

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

Код возврата Описание
E_INVALIDARG
Недопустимый тип кодирования сертификата. В настоящее время поддерживается только тип кодирования X509_ASN_ENCODING.
 

В случае сбоя функции GetLastError может вернуть ошибку кодирования и декодирования абстрактного синтаксиса (ASN.1). Сведения об этих ошибках см. в разделе Кодирование и декодирование возвращаемых значений ASN.1.

Комментарии

CRL_CONTEXT необходимо освободить, вызвав CertFreeCRLContext. Для создания дубликата можно вызвать CertDuplicateCRLContext. CertSetCRLContextProperty и CertGetCRLContextProperty можно вызывать для хранения и чтения свойств списка отзыва сертификатов.

Требования

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

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

CRL_CONTEXT

CertCreateCTLContext

CertCreateCertificateContext

CertDuplicateCRLContext

CertFreeCRLContext

CertGetCRLContextProperty

CertSetCRLContextProperty

Функции списка отзыва сертификатов