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.

MethodDescription
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

Credentialprovider.h

IDL

Credentialprovider.idl

Library

CredentialProvider.lib

DLL

Authui.dll

See also

ICredentialProviderCredentialEvents2
ICredentialProviderCredential::Advise
ICredentialProviderCredential::UnAdvise
Credential Providers in Windows 10

 

 

Show: