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 の後に呼び出されます。 ログオン UI は、フィルターが UpdateRemoteCredential を介して資格情報を返すときにも SetSerialization を呼び出します。 CredentialsChanged の呼び出しのためにタイルを再列挙する場合、このメソッドは使用されません。 資格情報 UI は、アプリケーションから入力資格情報が指定されたときに SetSerialization を呼び出します。

資格情報 UI では、SetUsageScenario が呼び出されたときに定義されたこのコンテンツ プロバイダー インスタンスの dwFlags に基づいて、次の規則が適用されます。

• フラグに CREDUIWIN_IN_CRED_ONLYが含まれている場合、 S_OK を返すすべての資格情報プロバイダーが有効になります。
• フラグに CREDUIWIN_AUTHPACKAGE_ONLYが含まれている場合、成功状態を返すすべての資格情報プロバイダーが有効になります。
• どちらのフラグも含まれていない場合、Credential UI はログオン UI と同じロジックに従い、CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_REDUIを実装するすべての資格情報プロバイダーは、返された状態値に関係なく有効になります。

Requirements