CertCreateCRLContext 関数 (wincrypt.h)

CertCreateCRLContext 関数は、エンコードされた CRL から証明書失効リスト (CRL) コンテキストを作成します。作成されたコンテキストは、証明書ストアに永続化されません。これにより、作成されたコンテキスト内でエンコードされた CRL のコピーが作成されます。

構文

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

[in] dwCertEncodingType

使用するエンコードの種類を指定します。次の例に示すように、証明書とメッセージエンコードの両方の種類をビットごとの OR 操作と組み合わせて指定することは、常に許容されます。

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。

[in] pbCrlEncoded

コンテキストの作成元となるエンコードされた CRL を含むバッファーへのポインター。

[in] cbCrlEncoded

pbCrlEncoded バッファーのサイズ (バイト単位)。

関数が成功した場合、戻り値は読み取り専用 CRL_CONTEXTへのポインターです。

関数が失敗し、 CRL_CONTEXTをデコードして作成できない場合、戻り値は NULL になります。拡張エラー情報については、 GetLastError を呼び出します。次の表に、考えられるエラーコードを示します。

リターンコード	説明
E_INVALIDARG	証明書のエンコードの種類が無効です。現在、X509_ASN_ENCODINGエンコードの種類のみがサポートされています。

関数が失敗した場合、GetLastError は抽象構文表記 1 (ASN.1) エンコード/デコードエラーを返す可能性があります。これらのエラーの詳細については、「 ASN.1 エンコード/デコードの戻り値」を参照してください。

CRL_CONTEXTは、CertFreeCRLContext を呼び出して解放する必要があります。 CertDuplicateCRLContext を呼び出して、重複を作成できます。 CRL のプロパティを格納および読み取るために、 CertSetCRLContextProperty と CertGetCRLContextProperty を呼び出すことができます。

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	wincrypt.h
Library	Crypt32.lib
[DLL]	Crypt32.dll