ICredentialProvider：：SetSerialization 方法 （credentialprovider.h）

設定認證提供者的序列化特性。

語法

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

參數

[in] pcpcs

類型： const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

儲存認證提供者序列化特性的 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 結構指標。

返回值

類型： HRESULT

如果這個方法成功，它會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此方法是必需的。 它接受認證並判斷 pcpcs 是部分認證還是完整認證。 如果它是部分認證，則它是不完整的，或者是為了向使用者顯示某些資訊而傳遞的。 如果是完整認證，則應序列化並提交。 使用 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 的成員和 SetUsageScenario 中傳遞的旗標來判斷如何處理輸入。 認證提供者有責任驗證輸入的完整性。 認證 UI 和登入 UI 不會在將結構傳遞至認證提供者之前，對結構執行任何檢查。

SetSerialization 一律會在 SetUsageScenario 之後呼叫。 當篩選條件透過 UpdateRemoteCredential 傳回認證時，登入 UI 也會呼叫 SetSerialization。 由於呼叫 CredentialsChanged，因此重新列舉磚時，它不會使用此方法。 認證 UI 會在應用程式提供輸入認證時呼叫 SetSerialization 。

認證 UI 會根據呼叫 SetUsageScenario 時定義之此內容提供者實例的 dwFlags 強制執行下列規則。

• 如果旗標包含 CREDUIWIN_IN_CRED_ONLY，則會啟用所有傳回 S_OK 的認證提供者。
• 如果旗標包含 CREDUIWIN_AUTHPACKAGE_ONLY，則會啟用所有傳回成功狀態的認證提供者。
• 如果這兩個旗標都未包含，則認證 UI 會遵循與登入 UI 相同的邏輯，而不論傳回的狀態值為何，都會啟用實作 CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_REDUI 認證提供者。

需求