ICertPropertyFriendlyName：：Initialize 方法（certenroll.h）

Initialize 方法从证书显示名称初始化对象。此方法已启用 Web。

Syntax

HRESULT Initialize(
  [in] BSTR strFriendlyName
);

[in] strFriendlyName

包含名称的 BSTR 变量。字符串长度不能超过 260 个字符。

如果函数成功，该函数将返回 S_OK。

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

返回代码/值	Description
HRESULT_FROM_WIN32（ERROR_ALREADY_INITIALIZED）	对象已初始化。
HRESULT_FROM_WIN32（ERROR_FILENAME_EXCED_RANGE）	字符串长度超过 260 个字符。

通常，在开始注册过程之前，在用户界面或命令行中指定显示名称，以便该名称可与请求存储中的虚拟证书相关联。若要检索该值并在此处使用它，请调用 IX509Enrollment 接口上的 CertificateFriendlyName。

调用 SetValueOnCertificate 方法，将属性与证书相关联。调用 FriendlyName 属性以检索显示名称。