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 |