共用方式為

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 值。

傳回碼/值 Description
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
對象已經初始化。

備註

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

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

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 certenroll.h
Dll CertEnroll.dll

另請參閱

ICertProperty

ICertPropertyEnrollment