Método IIdentityProvider::Advise (identityprovider.h)

  • Artigo

O método Advise permite que um aplicativo de chamada especifique a lista de eventos de identidade para os quais o aplicativo deve ser notificado.

Sintaxe

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

Parâmetros

[in] pIdentityAdvise

Um ponteiro para a interface IIdentityAdvise implementada pelo aplicativo de chamada. Essa interface fornece um método que o provedor de identidade pode chamar quando ocorre um dos eventos especificados pelo parâmetro dwIdentityUpdateEvents .

[in] dwIdentityUpdateEvents

Os eventos de identidade para os quais o aplicativo de chamada deve ser notificado. O valor desse parâmetro pode ser zero ou mais dos valores a seguir combinados usando uma operação OR bit a bit.

Valor Significado
IDENTITY_ASSOCIATED
0X0001
 Uma identidade foi associada ao provedor de identidade.
IDENTITY_DISASSOCIATED
0X0002
 Uma identidade foi desassociada do provedor de identidade.
IDENTITY_CREATED
0X0004
 Uma nova identidade foi criada.
IDENTITY_IMPORTED
0X0008
 Uma identidade foi importada de outro provedor de identidade.
IDENTITY_DELETED
0X0010
 Uma identidade foi excluída do repositório de identidades.
IDENTITY_PROPCHANGE
0X0020
 O valor de uma propriedade de uma identidade foi alterado.

[out] pdwCookie

Um ponteiro para um valor que identifica essa conexão. Quando terminar de usar essa conexão, exclua-a passando esse valor para o método UnAdvise .

Valor retornado

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um código de erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho identityprovider.h

Confira também

IIdentityAdvise::IdentityUpdated

IIdentityProvider