ICredentialProviderCredentialEvents interface
Provides an asynchronous callback mechanism used by a credential to notify it of state or text change events in the Logon UI or Credential UI.
Members
The ICredentialProviderCredentialEvents interface inherits from the IUnknown interface. ICredentialProviderCredentialEvents also has these types of members:
Methods
The ICredentialProviderCredentialEvents interface has these methods.
| Method | Description |
|---|---|
| AppendFieldComboBoxItem |
Communicates to the Logon UI or Credential UI that a combo box needs an item appended and that the UI should be updated. |
| DeleteFieldComboBoxItem |
Communicates to the Logon UI or Credential UI that an item should be deleted from a combo box and that the UI should be updated. |
| OnCreatingWindow |
Called when the window is created. Enables credentials to retrieve the HWND of the parent window after Advise is called. |
| SetFieldBitmap |
Communicates to the Logon UI or Credential UI that a tile image field has changed and that the UI should be updated. |
| SetFieldCheckbox |
Communicates to the Logon UI or Credential UI that a checkbox field has changed and that the UI should be updated. |
| SetFieldComboBoxSelectedItem |
Communicates to the Logon UI or Credential UI that the selected item in a combo box has changed and that the UI should be updated. |
| SetFieldInteractiveState |
Communicates to the Logon UI or Credential UI that the interactivity state of a field has changed and that the UI should be updated. |
| SetFieldState |
Communicates to the Logon UI or Credential UI that a field state has changed and that the UI should be updated. |
| SetFieldString |
Communicates to the Logon UI or Credential UI that the string associated with a field has changed and that the UI should be updated. |
| SetFieldSubmitButton |
Enables credentials to set the field that the submit button appears adjacent to. |
Remarks
These methods should only be called by a credential passing this as the first parameter. Behavior is undefined if you attempt to call these methods using a credential other than the one activated by the call on Advise. If a credential provider has information on another thread and wants to communicate through that thread's Logon UI or Credential UI, the requests will need to go through the credential that received the Advise call.
When to Implement
Third parties do not implement ICredentialProviderCredentialEvents. An implementation is included with Windows.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|
|
Library |
|
|
DLL |
|
See also
- ICredentialProviderCredentialEvents2
- ICredentialProviderCredential::Advise
- ICredentialProviderCredential::UnAdvise
- Credential Providers in Windows 10