共用方式為

IX509EnrollmentPolicyServer：：Initialize 方法 (certenroll.h)

  • 發行項

Initialize 方法會初始化 IX509EnrollmentPolicyServer 物件。

語法

HRESULT Initialize(
  [in] BSTR                             bstrPolicyServerUrl,
  [in] BSTR                             bstrPolicyServerId,
  [in] X509EnrollmentAuthFlags          authFlags,
  [in] VARIANT_BOOL                     fIsUnTrusted,
  [in] X509CertificateEnrollmentContext context
);

參數

[in] bstrPolicyServerUrl

包含憑證註冊原則伺服器的 URL 的 BSTR 變數。

[in] bstrPolicyServerId

BSTR 變數，其中包含憑證註冊原則伺服器的唯一標識符。 如果此值不是 NULL，它必須符合 CEP 回應所傳回的標識符字串。

[in] authFlags

指定客戶端驗證類型的 X509EnrollmentAuthFlags 列舉值。 這可以是下列其中一個值。

值 意義
X509AuthAnonymous
 匿名驗證。
X509AuthKerberos
 Kerberos 驗證。
X509AuthUsername
 純文字用戶名稱和密碼驗證。
注意 使用者名稱和密碼會在傳輸之前加密，並安全地儲存在 CEP 伺服器上的認證保存庫中。
 
X509AuthCertificate
 安裝在本機電腦上的用戶端驗證憑證，並由伺服器用來驗證用戶端的身分識別。

[in] fIsUnTrusted

布爾值，指定是否允許不受信任的證書頒發機構單位憑證。

[in] context

X509CertificateEnrollmentContext 列舉值，指定要註冊憑證之結束實體的本質。 這可以是下列其中一個值。

值 意義
ContextUser
 憑證適用於使用者。
ContextMachine
 憑證適用於計算機。
ContextAdministratorForceMachine
 系統管理員正在代表計算機要求憑證。

傳回值

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

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

傳回碼 Description
E_INVALIDARG
 bstrPolicyServerUrl 參數不能是空字串，而且必須代表 HTTPS URL。
E_OUTOFMEMORY
 bstrPolicyServerUrl 或 bstrPolicyServerId 參數中指定的字串沒有足夠的記憶體可用。
HRESULT_FROM_WIN32 (ERROR_ALREADY_INITIALIZED)
IX509EnrollmentPolicyServer 對象已經初始化。
HRESULT_FROM_WIN32 (ERROR_INVALID_DATA)
bstrPolicyServerId 參數中指定的值不是 NULL，而且不等於 CEP 伺服器上的現有 CEP 識別符值。

規格需求

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

另請參閱

IX509EnrollmentPolicyServer