ICertPropertyFriendlyName：：Initialize 方法 (certenroll.h)

Initialize 方法會從憑證顯示名稱初始化物件。此方法已啟用 Web。

語法

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 屬性以擷取顯示名稱。