ICredentialProviderCredentialEvents2 interface

Extends the ICredentialProviderCredentialEvents interface by adding methods that enable batch updating of fields in a logon or credential UI.

Members

The ICredentialProviderCredentialEvents2 interface inherits from ICredentialProviderCredentialEvents. ICredentialProviderCredentialEvents2 also has these types of members:

Methods

The ICredentialProviderCredentialEvents2 interface has these methods.

MethodDescription
BeginFieldUpdates

Starts a batch update to fields in the logon or credential UI.

EndFieldUpdates

Finishes and commits the batch updates started by BeginFieldUpdates.

SetFieldOptions

Specifies whether a specified field in the logon or credential UI should display a "password reveal" glyph or is expected to receive an e-mail address.

 

Remarks

In Windows 7 and Windows Vista, many credential providers used ICredentialProviderEvents::CredentialsChanged to update UI. While this works, it causes a re-enumeration of all the credentials from the calling credential provider. The processing of this event can, under some circumstances, lead to flashing or focus changes in the UI due to this re-enumeration. Therefore, using ICredentialProviderEvents::CredentialsChanged solely for UI updates is discouraged. The new recommendation is as follows:

  • Use ICredentialProviderEvents::CredentialsChanged only if a credential provider needs to do an autologon or change the number of credentials it is enumerating.
  • Use ICredentialProviderCredentialEvents2 to update a credential provider's UI.

ICredentialProviderCredentialEvents2 includes all of the methods inherited from ICredentialProviderCredentialEvents. However, in any inherited method in which the first parameter is an ICredentialProviderCredential pointer, that parameter is now deprecated and should be set to a null pointer. This includes all of the inherited methods except OnCreatingWindow.

When interacting with a background thread, the use of ICredentialProviderCredentialEvents2 is similar to the use of ICredentialProviderCredentialEvents, in that proper inter-thread communication methods must be used.

When to implement

Third-parties do not implement this interface. Call the QueryInterface method on ICredentialProviderCredentialEvents to obtain this object.

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Header

CredentialProvider.h

IDL

CredentialProvider.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft