共用方式為

CertAddEncodedCertificateToSystemStoreW 函式 (wincrypt.h)

  • 發行項

CertAddEncodedCertificateToSystemStore 函式會開啟指定的系統存放區，並將編碼的憑證加入其中。

語法

BOOL CertAddEncodedCertificateToSystemStoreW(
  [in] LPCWSTR    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 標頭會根據 UNICODE 預處理器常數的定義，將 CertAddEncodedCertificateToSystemStore 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll