ICertPropertyFriendlyName：：Initialize 方法 (certenroll.h)

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

语法

HRESULT Initialize(
  [in] BSTR strFriendlyName
);

[in] strFriendlyName

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

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

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

返回代码/值	说明
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)	对象已初始化。
HRESULT_FROM_WIN32 (ERROR_FILENAME_EXCED_RANGE)	字符串长度超过 260 个字符。

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

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