Metodo IIdentityProvider::Advise (identityprovider.h)

Il metodo Advise consente a un'applicazione chiamante di specificare l'elenco di eventi di identità per cui l'applicazione deve ricevere una notifica.

Sintassi

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

Parametri

[in] pIdentityAdvise

Puntatore all'interfaccia IIdentityAdvise implementata dall'applicazione chiamante. Questa interfaccia fornisce un metodo che il provider di identità può chiamare quando si verifica uno degli eventi specificati dal parametro dwIdentityUpdateEvents .

[in] dwIdentityUpdateEvents

Eventi di identità per i quali l'applicazione chiamante deve ricevere una notifica. Il valore di questo parametro può essere zero o più dei valori seguenti combinati usando un'operazione OR bit per bit.

Valore	Significato
IDENTITY_ASSOCIATED 0X0001	Un'identità è stata associata al provider di identità.
IDENTITY_DISASSOCIATED 0X0002	Un'identità è stata disassociata dal provider di identità.
IDENTITY_CREATED 0X0004	È stata creata una nuova identità.
IDENTITY_IMPORTED 0X0008	Un'identità è stata importata da un altro provider di identità.
IDENTITY_DELETED 0X0010	Un'identità è stata eliminata dall'archivio identità.
IDENTITY_PROPCHANGE 0X0020	Valore di una proprietà di un'identità modificata.

[out] pdwCookie

Puntatore a un valore che identifica questa connessione. Al termine dell'utilizzo di questa connessione, eliminarlo passando questo valore al metodo UnAdvise .

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, viene restituito un codice errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti

Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	identityprovider.h

Vedi anche

IIdentityAdvise::IdentityUpdated

IIdentityProvider