CertCreateContext 関数 (wincrypt.h)

CertCreateContext 関数は、エンコードされたバイトから指定されたコンテキストを作成します。 作成されたコンテキストには、拡張プロパティは含まれません。

構文

const void * CertCreateContext(
  [in]           DWORD                     dwContextType,
  [in]           DWORD                     dwEncodingType,
  [in]           const BYTE                *pbEncoded,
  [in]           DWORD                     cbEncoded,
  [in]           DWORD                     dwFlags,
  [in, optional] PCERT_CREATE_CONTEXT_PARA pCreatePara
);

パラメーター

[in] dwContextType

作成できるコンテキストを指定します。 たとえば、 証明書コンテキストを作成するには、 dwContextType を CERT_STORE_CERTIFICATE_CONTEXT に設定します。

現在定義されているコンテキスト型フラグを次の表に示します。

[in] dwEncodingType

使用するエンコードの種類を指定します。 現在、X509_ASN_ENCODINGとPKCS_7_ASN_ENCODINGのみが使用されています。ただし、今後、エンコードの種類が追加される可能性があります。 現在のエンコードの種類の場合は、次の値を使用します。

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING。

[in] pbEncoded

コピーする既存のエンコードされたコンテキスト コンテンツを含むバッファーへのポインター。

[in] cbEncoded

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

[in] dwFlags

次のフラグ値が定義されており、ビットごとの OR 演算を使用して組み合わせることができます。

[in, optional] pCreatePara

CERT_CREATE_CONTEXT_PARA構造体へのポインター。

pCreatePara とその pfnFree メンバーの両方が NULL 以外の場合、pfnFree メンバーを使用して、pvFree メンバーで指定されたメモリを解放します。 pvFree メンバーが NULL の場合、pfnFree メンバーを使用して pbEncoded ポインターを解放します。

pCreatePara またはその pfnFree メンバーが NULL の場合、pbEncoded の解放は試行されません。

戻り値

関数が成功した場合、戻り値は新しく作成されたコンテキストへのポインターです。 作成されたコンテキストを解放するには、pCreatePara のpvFree メンバーを呼び出す必要があります。

関数が失敗した場合は、返される値は NULL です。 拡張エラー情報については、 GetLastError を呼び出します。

GetLastError がERROR_CANCELLEDを返す場合は、PFN_CERT_CREATE_CONTEXT_SORT_FUNCコールバック関数が FALSE を返して並べ替えを停止したことを意味します。

要件

こちらもご覧ください

CTL_INFO

CertEnumSubjectInSortedCTL

CertFindSubjectInSortedCTL

証明書と証明書ストアのメンテナンス機能