IDataObject::EnumDAdvise

9/8/2008

Esse método cria um objeto que pode ser usado para enumerar o atual de consultoria conexões.

Syntax

HRESULT EnumDAdvise(
  IEnumSTATDATA** ppenumAdvise
);

Parameters

• ppenumAdvise
  [out] Endereço das IEnumSTATDATA* ponteiro variável que recebe o ponteiro interface para o novo objeto enumerador.

  Se a implementação define *ppenumAdvise Para NULL, não há nenhum conexões para informar recpetores nesse tempo.

Return Value

Este método oferece suporte a padrão valor de retorno E_OUTOFMEMORY.

Se o objeto enumerador está com êxito instanciado ou não há nenhuma conexão, o método Retorna S_OK.

Se o de consultoria as notificações não estão com suporte por esse objeto, OLE_E_ADVISENOTSUPPORTED é retornado.

Remarks

O objeto enumerador criado por este método implementa o IEnumSTATDATA interface, que é um do padrão interfaces enumerador que contêm o Próxima, Redefinir,Clone, e Ignorar Métodos.

IEnumSTATDATA Permite a enumeração dos dados armazenados em uma matriz de STATDATA estruturas.

Cada uma dessas estruturas fornece informações em uma única de consultoria conexão e inclui FORMATETC e ADVF informações, bem como o ponteiro para o coletor de avisos e o token que representa a conexão.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Notas para chamadores

Após obter um ponteiro por esse método, o objeto de dados pode chamar o apropriado métodos enumeração. Enquanto a enumeração está em andamento, o efeito de adicionar mais de consultoria conexões a enumeração subseqüente é indefinido.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IEnumSTATDATA
ADVF
FORMATETC
STATDATA