Freigeben über

IIdentityProvider::Advise-Methode (identityprovider.h)

  • Artikel

Mit der Advise-Methode kann eine aufrufende Anwendung die Liste der Identitätsereignisse angeben, für die die Anwendung benachrichtigt werden soll.

Syntax

HRESULT Advise(
  [in]  IIdentityAdvise *pIdentityAdvise,
  [in]  DWORD           dwIdentityUpdateEvents,
  [out] DWORD           *pdwCookie
);

Parameter

[in] pIdentityAdvise

Ein Zeiger auf die IIdentityAdvise-Schnittstelle, die von der aufrufenden Anwendung implementiert wird. Diese Schnittstelle stellt eine Methode bereit, die der Identitätsanbieter aufrufen kann, wenn eines der vom dwIdentityUpdateEvents-Parameter angegebenen Ereignisse auftritt.

[in] dwIdentityUpdateEvents

Die Identitätsereignisse, über die die aufrufende Anwendung benachrichtigt werden soll. Der Wert dieses Parameters kann null oder mehr der folgenden Werte sein, die mithilfe einer bitweisen OR-Operation kombiniert werden.

Wert Bedeutung
IDENTITY_ASSOCIATED
0X0001
 Dem Identitätsanbieter wurde eine Identität zugeordnet.
IDENTITY_DISASSOCIATED
0X0002
 Eine Identität wurde dem Identitätsanbieter nicht zugeordnet.
IDENTITY_CREATED
0X0004
 Eine neue Identität wurde erstellt.
IDENTITY_IMPORTED
0X0008
 Eine Identität wurde von einem anderen Identitätsanbieter importiert.
IDENTITY_DELETED
0X0010
 Eine Identität wurde aus dem Identitätsspeicher gelöscht.
IDENTITY_PROPCHANGE
0X0020
 Der Wert einer Eigenschaft einer Geänderten Identität.

[out] pdwCookie

Ein Zeiger auf einen Wert, der diese Verbindung identifiziert. Wenn Sie die Verwendung dieser Verbindung abgeschlossen haben, löschen Sie sie, indem Sie diesen Wert an die UnAdvise-Methode übergeben.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile identityprovider.h

Weitere Informationen

IIdentityAdvise::IdentityUpdated

IIdentityProvider