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

Статья
08/27/2023

Функция 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