CertAddEncodedCertificateToSystemStoreA 関数 (wincrypt.h)

CertAddEncodedCertificateToSystemStore 関数は、指定されたシステム ストアを開き、エンコードされた証明書を追加します。

構文

BOOL CertAddEncodedCertificateToSystemStoreA(
  [in] LPCSTR     szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

パラメーター

[in] szCertStoreName

エンコードされた証明書のシステム ストアの名前を含む null で終わる文字列。

[in] pbCertEncoded

追加するエンコードされた証明書を含むバッファーへのポインター。

[in] cbCertEncoded

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

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。 CertAddEncodedCertificateToSystemStore は、エラー処理に関する次の解説に記載されている関数に依存します。 それぞれのエラー処理の動作については、これらの関数トピックを参照してください。 拡張エラー情報については、 GetLastError を呼び出します。

解説

内部的には、 CertAddEncodedCertificateToSystemStore は、次のパラメーターを使用して CertOpenSystemStore と CertAddEncodedCertificateToStore を呼び出します。

CertOpenSystemStore パラメーター	値
szSubsystemProtocol	szCertStoreName

 

CertAddEncodedCertificateToSystemStore が指定されたシステム ストアへのハンドルを取得した場合、CertCloseStore を呼び出してハンドルを閉じてから、ハンドルが返されます。

CertAddEncodedCertificateToStore パラメーター	値
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

 

注意

wincrypt.h ヘッダーは、CertAddEncodedCertificateToSystemStore をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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