Share via

Método IDataAdviseHolder::SendOnDataChange (objidl.h)

  • Artigo

Envia notificações para cada coletor de avisos para o qual há uma conexão estabelecida chamando o método IAdviseSink::OnDataChange para cada coletor de consultoria que está sendo tratado por esta instância do objeto titular de consultoria.

Sintaxe

HRESULT SendOnDataChange(
  [in] IDataObject *pDataObject,
  [in] DWORD       dwReserved,
  [in] DWORD       advf
);

Parâmetros

[in] pDataObject

Um ponteiro para a interface IDataObject no objeto de dados no qual os dados acabaram de ser alterados. Esse ponteiro é usado em chamadas subsequentes para IAdviseSink::OnDataChange.

[in] dwReserved

Esse parâmetro é reservado e deve ser 0.

[in] advf

Contêiner para sinalizadores de aviso que especificam como a chamada para IAdviseSink::OnDataChange é feita. Esses valores de sinalizador são do ADVF de enumeração. Normalmente, o valor de advf é NULL. A única exceção ocorre quando o objeto de dados está sendo desligado e deve enviar uma notificação final que inclua os dados reais para coletores que especificaram ADVF_DATAONSTOP e ADVF_NODATA em sua chamada para IDataObject::D Advise. Nesse caso, advf contém ADVF_DATAONSTOP.

Retornar valor

Esse método retorna S_OK em caso de êxito.

Comentários

O objeto de dados deve chamar esse método quando detecta uma alteração que seria de interesse para um coletor de avisos que já solicitou notificação.

A maioria das notificações inclui os dados reais com eles. A única exceção é se o sinalizador ADVF_NODATA foi especificado anteriormente quando a conexão foi inicialmente configurada no método IDataAdviseHolder::Advise .

Antes de chamar o método IAdviseSink::OnDataChange para cada coletor de consultoria, esse método obtém os dados reais chamando o método IDataObject::GetData por meio do ponteiro especificado no parâmetro pDataObject .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

IAdviseSink::OnDataChange

IDataAdviseHolder