Método IDataAdviseHolder::SendOnDataChange (objidl.h)
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 |