iCertProperty::RemoveFromCertificate 方法 (certenroll.h)

RemoveFromCertificate 方法取消属性与证书的关联。 通过调用 PropertyId 属性指定要删除的属性。

语法

HRESULT RemoveFromCertificate(
  [in] VARIANT_BOOL MachineContext,
  [in] EncodingType Encoding,
  [in] BSTR         strCertificate
);

参数

[in] MachineContext

一个VARIANT_BOOL值,该值指示证书存储是否位于本地计算机上。 如果存储是本地存储,请指定 VARIANT_TRUE

[in] Encoding

一个 EncodingType 枚举值,该值指定应用于 strCertificate 参数标识的证书字符串的编码类型。

[in] strCertificate

包含 DER 编码证书的 BSTR 变量。

从 Windows 7 和 Windows Server 2008 R2 开始,可以指定证书指纹或序列号,而不是编码的证书。 这样做会导致函数在相应的本地存储中搜索匹配的证书。 请注意以下几点:

  • BSTR 必须是偶数个十六进制数字。
  • 忽略十六进制对之间的空格。
  • Encoding 参数必须设置为 XCN_CRYPT_STRING_HEXRAW
  • MachineContext 参数确定是搜索用户或计算机存储还是同时搜索这两者。
  • 如果需要私钥,则仅搜索个人和请求存储。
  • 如果不需要私钥,则还会搜索根和中间 CA 存储。

返回值

如果函数成功,该函数将返回 S_OK

如果函数失败,它将返回指示错误的 HRESULT 值。 可能的值包括(但并不限于)下表中的项。 有关常见错误代码的列表,请参阅 常见 HRESULT 值

返回代码/值 说明
CRYPT_E_NOT_FOUND
找不到证书。
CRYPT_E_UNEXPECTED_MSG_TYPE
找到证书,但无法加载私钥。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

ICertProperties

ICertProperty