ICredentialProviderCredential インターフェイス (credentialprovider.h)

  • [アーティクル]

資格情報の処理を有効にするメソッドを公開します。

継承

ICredentialProviderCredential インターフェイスは、IUnknown インターフェイスから継承されます。 ICredentialProviderCredential には、次の種類のメンバーもあります。

メソッド

ICredentialProviderCredential インターフェイスには、これらのメソッドがあります。

 
ICredentialProviderCredential::Advise

資格情報がコールバック インターフェイスを介してログオン UI または資格情報 UI でイベントを開始できるようにします。 このメソッドは、ICredentialProviderCredential インターフェイスの他のメソッドの前に呼び出す必要があります。
ICredentialProviderCredential::CommandLinkClicked

[ログオン UI] と [資格情報 UI] を有効にして、リンクがクリックされたことを示します。
ICredentialProviderCredential::GetBitmapValue

ビットマップ フィールドを使用して資格情報からビットマップ データを取得できるようにします。
ICredentialProviderCredential::GetCheckboxValue

チェック ボックスの値を取得します。
ICredentialProviderCredential::GetComboBoxValueAt

指定したインデックスにあるコンボ ボックス エントリの文字列ラベルを取得します。
ICredentialProviderCredential::GetComboBoxValueCount

指定したコンボ ボックス内の項目の数を取得し、最初に選択する項目を指定します。
ICredentialProviderCredential::GetFieldState

フィールドの状態を取得します。 ログオン UI と資格情報 UI は、これを使用して資格情報のフィールドに関する情報を取得し、この情報をユーザー タイルに表示します。
ICredentialProviderCredential::GetSerialization

基になる認証エンジンにこの資格情報を送信しようとした場合に応答して呼び出されます。
ICredentialProviderCredential::GetStringValue

テキスト フィールドを使用して資格情報からテキストを取得できるようにします。
ICredentialProviderCredential::GetSubmitButtonValue

ログオン UI の横に送信ボタンを配置するフィールドの識別子を取得します。
ICredentialProviderCredential::ReportResult

受信したエラー状態コードを、適切なユーザーが読み取り可能なメッセージに変換します。
ICredentialProviderCredential::SetCheckboxValue

ログオン UI と資格情報 UI を有効にして、チェック ボックスの値が変更されたことを示します。
ICredentialProviderCredential::SetComboBoxSelectedValue

ログオン UI と資格情報 UI を有効にして、コンボ ボックスの値が選択されていることを示します。
ICredentialProviderCredential::SetDeselected

資格情報の選択が失われると呼び出されます。
ICredentialProviderCredential::SetSelected

資格情報が選択されたときに呼び出されます。 実装者がログオン特性を設定できるようにします。
ICredentialProviderCredential::SetStringValue

ログオン UI または資格情報 UI で、ユーザーが入力したCPFT_EDIT_TEXTフィールドのテキストを更新できるようにします。
ICredentialProviderCredential::UnAdvise

ログオン UI または資格情報 UI によって使用され、イベント コールバックが受け入れられないことを資格情報に通知します。

解説

実装するタイミング

ICredentialProviderCredential は、ユーザーの資格情報を求めるログオン UI または資格情報 UI を提供する外部パーティによって実装されます。 このインターフェイスを実装しないと、ユーザー タイルの列挙を行うことはできません。

資格情報プロバイダーのベスト プラクティス

資格情報プロバイダーは、ログオンとロック解除の要求を完了するために、非常に機密性の高いユーザー シークレットを処理します。 ベスト プラクティスとして、パスワードや PIN などのシークレット情報は細心の注意を払って処理する必要があります。 資格情報プロバイダー内でシークレット情報を処理するための適切な手法は次のとおりです。
  • シークレットは常に安全に破棄します。 これを行うには、シークレットを保持するために使用されるメモリを解放する前に 、SecureZeroMemory を呼び出します。
  • シークレットを使用した後、すぐに安全に破棄します。
  • 意図した目的で予期した時間内にシークレットが使用されない場合は、シークレットを安全に破棄します。

要件

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

関連項目

Windows 10の資格情報プロバイダー

ICredentialProvider