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

CPUS_LOGONのCREDENTIAL_PROVIDER_USAGE_SCENARIOを実装し、このメソッドからエラーを返す資格情報プロバイダーは引き続き有効になります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	credentialprovider.h