IOleAdviseHolder::EnumAdvise
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Esse método cria um enumerador que pode ser usado para enumerar a de consultoria conexões estabelecidas para um objeto e fornece um ponteiro para sua IEnumSTATDATA interface.
Syntax
HRESULT EnumAdvise(
IENumSTATDATA* ppEnumAdvise
);
Parameters
ppEnumAdvise
[out] Endereço do IEnumSTATDATAvariável * pointer que recebe o ponteiro interface para o novo enumerador.A NULL valor para *ppenumAdvise indica que há não de consultoria conexões de objeto, ou que ocorreu um erro.
O reservado Advise é responsável por incrementar a contagem de referência na IEnumSTATDATA ponteiro Este método fornece. É responsabilidade do chamador para chamar IUnknown::Release Quando ele é feito com o ponteiro.
Return Value
Este método oferece suporte a padrão valor de retorno E_FAIL, bem como os valores descritos a seguinte tabela.
| Valor | Descrição |
|---|---|
S_OK |
Enumerador criado com êxito. |
E_NOTIMPL |
EnumAdvise não é implementada. |
Remarks
EnumAdvise Cria um enumerador que pode ser usado para enumerar de consultoria estabelecidas de um objeto as conexões. O método fornece um ponteiro para o IEnumSTATDATA interface neste enumerador.
Informações do Comunicado conexão para cada conexão são armazenadas na STATDATA estrutura e o enumerador devem ser capaz de enumerar essas estruturas, definidas como segue.
typedef struct tagSTATDATA {
FORMATETC Formatetc;
DWORD grfAdvf;
IAdviseSink * pAdvise;
DWORD dwConnection;
}STATDATA;
Para este método, os membros estrutura somente relevantes são pAdvise e dwConnection. Outros membros contêm dados de consultoria informações.
Quando você chamar os métodos enumeração, e enquanto é uma enumeração em andamento, o efeito de registrar ou revogando de consultoria conexões no que é para ser enumerados é indefinido.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requirements
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleAdviseHolder
IEnumSTATDATA
IUnknown::Release
STATDATA