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 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	wincrypt.h
库	Crypt32.lib
DLL	Crypt32.dll