ICertPropertyEnrollment：：Initialize 方法 (certenroll.h)

Initialize 方法會從憑證要求標識碼、證書頒發機構單位 (CA) 組態字串和選擇性憑證顯示名稱初始化 屬性。

語法

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

參數

[in] RequestId

包含憑證要求標識碼的 LONG 變數。 註冊程式會建立要求標識碼。 您可以在 IX509Enrollment 介面上呼叫 RequestId 屬性，以擷取此值。

[in] strCADnsName

BSTR 變數，其中包含 CA 的功能變數名稱系統 (DNS) 名稱。 這是 CADnsName\CAName CA 組態字串中的名字。 設定字串通常會在註冊程序期間設定。 您可以藉由呼叫 CAConfigString 屬性，並將字串分成其組成部分來擷取 DNS 名稱。

[in] strCAName

BSTR 變數，其中包含 CA) 的主體通用名稱 (。 這是 CADnsName\CAName CA 組態字串中的第二個名稱。 設定字串通常會在註冊程序期間設定。 您可以藉由呼叫 CAConfigString 屬性，並將字串分成其組成部分來擷取 CN 名稱。

[in, optional] strFriendlyName

BSTR 變數，其中包含憑證的選擇性顯示名稱。 預設值是 NULL。 此值通常會在註冊程序期間設定。 您可以呼叫 CertificateFriendlyName 屬性來擷取它。

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

當用戶端在 IX509Enrollment 物件上呼叫 Enrollment 方法時，您可以在憑證註冊程式期間設定可用來初始化 ICertPropertyEnrollment 物件的值。 也就是說，若要擷取要求標識碼，請在IX509Enrollment對象上呼叫 RequestId 屬性。 若要擷取憑證顯示名稱，請呼叫 CertificateFriendlyName 屬性。 若要擷取辨別名稱和一般名稱，請呼叫 CAConfigString 屬性，並將組態字串分成組成部分。

呼叫 SetValueOnCertificate 方法，將 屬性與憑證產生關聯。 您也可以呼叫下列屬性，以擷取初始化期間指定的值：

• CADnsName
• CAName
• FriendlyName
• RequestId

規格需求

另請參閱

ICertProperty

ICertPropertyEnrollment