ICertPropertyEnrollmentPolicyServer：：Initialize 方法 (certenroll.h)

  • 發行項

Initialize 方法會初始化 ICertPropertyEnrollmentPolicyServer 物件。

語法

HRESULT Initialize(
  [in] EnrollmentPolicyServerPropertyFlags PropertyFlags,
  [in] X509EnrollmentAuthFlags             AuthFlags,
  [in] X509EnrollmentAuthFlags             EnrollmentServerAuthFlags,
  [in] PolicyServerUrlFlags                UrlFlags,
  [in] BSTR                                strRequestId,
  [in] BSTR                                strUrl,
  [in] BSTR                                strId,
  [in] BSTR                                strEnrollmentServerUrl
);

參數

[in] PropertyFlags

EnrollmentPolicyServerPropertyFlags 列舉值，指定 CEP () 伺服器的默認憑證註冊原則。 這可以是下列其中一個值。

值 意義
DefaultNone
 未指定預設原則伺服器 URL。
DefaultPolicyServer
 未指定 URL 時 ，GetPolicyServerUrl 所傳回的原則伺服器 URL 是預設值。

[in] AuthFlags

X509EnrollmentAuthFlags 列舉值，指定用戶端用來向 CEP 伺服器驗證本身的驗證類型。 這可以是下列其中一個值。

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

[in] EnrollmentServerAuthFlags

X509EnrollmentAuthFlags 列舉值，指定用戶端用來向 CES 驗證本身的驗證類型。 如需列舉類型的可能值，請參閱 AuthFlags 參數。 針對 Windows 7，只能指定 X509AuthCertificate 。

[in] UrlFlags

PolicyServerUrlFlags 列舉值，指定原則伺服器旗標。 這可以是下列值的位 OR 。

值 意義
PsfNone
 未指定旗標。
PsfLocationGroupPolicy
 原則伺服器 URL 是由系統管理員在組策略中指定。
PsfLocationRegistry
 原則伺服器 URL 是在登錄中指定。
PsfUseClientId
 指定憑證註冊和更新包含 ClientId 屬性中的用戶端特定數據。 範例包括密碼編譯服務提供者的名稱、Windows 版本號碼、使用者名稱、計算機 DNS 名稱和域控制器 DNS 名稱。

此旗標已納入，以解決註冊期間可能發生的隱私權考慮，這些伺服器是由管理使用者所在樹系以外的系統管理員所管理。 若未設定此旗標，您可以防止將個人資訊傳送給非本機系統管理員。
PsfAutoEnrollmentEnabled
 已啟用自動憑證註冊。
PsfAllowUnTrustedCA
 指定用戶端不需要信任發行 CA 的憑證，才能安裝由 CA 簽署的憑證。

[in] strRequestId

BSTR 變數，其中包含註冊期間要傳送至證書頒發機構單位之憑證要求的唯一字串標識符。 字串可以包含可唯一識別要求的任何資訊。

[in] strUrl

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

[in] strId

包含 CEP 伺服器識別碼的 BSTR 變數。

[in] strEnrollmentServerUrl

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

傳回值

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

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

傳回碼 Description
E_OUTOFMEMORY
 字串值沒有足夠的記憶體可用。

規格需求

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

另請參閱

ICertPropertyEnrollmentPolicyServer