IIdentityAdvise::IdentityUpdated method (identityprovider.h)

The IdentityUpdated method is called by an identity provider to notify a calling application that an identity event occurred. An application calls the IIdentityProvider::Advise method to specify events for which it is to be notified.

Syntax

HRESULT IdentityUpdated(
  [in] DWORD   dwIdentityUpdateEvents,
  [in] LPCWSTR lpszUniqueID
);

Parameters

[in] dwIdentityUpdateEvents

The identity events that occurred. The value of this parameter can be zero or more of the following values combined by using a bitwise-OR operation.

Value Meaning
IDENTITY_ASSOCIATED
0X0001
An identity was associated with the identity provider.
IDENTITY_DISASSOCIATED
0X0002
An identity was disassociated from the identity provider.
IDENTITY_CREATED
0X0004
A new identity was created.
IDENTITY_IMPORTED
0X0008
An identity was imported from another identity provider.
IDENTITY_DELETED
0X0010
An identity was deleted from the identity store.
IDENTITY_PROPCHANGE
0X0020
The value of a property of an identity changed.
IDENTITY_CONNECTED
0X0040
The identity is a connected identity.
IDENTITY_DISCONNECTED
0X0080
The identity was disconnected from the identity provider.

[in] lpszUniqueID

The identity associated with the events that occurred.

Return value

If the method succeeds, it returns S_OK.

If the method fails, it returns an error code. For a list of common error codes, see Common HRESULT Values.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header identityprovider.h

See also

IIdentityAdvise