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

Retorna um objeto que pode ser usado para enumerar as conexões de consultoria atuais.

Sintaxe

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Parâmetros

[out] ppenumAdvise

Um ponteiro para uma variável de ponteiro IEnumSTATDATA que recebe o ponteiro de interface para o novo objeto enumerador. Se a implementação retornar NULL em *ppenumAdvise, não haverá conexões para aconselhar coletores no momento.

Retornar valor

Esse método retornará S_OK se o objeto enumerador for instanciado com êxito ou se não houver conexões.

Comentários

Esse método deve fornecer um ponteiro para uma implementação da interface IEnumSTATDATA . Seus métodos permitem enumerar os dados armazenados em uma matriz de estruturas STATDATA . Você obtém um ponteiro para a implementação OLE de IDataAdviseHolder por meio de uma chamada para CreateDataAdviseHolder e, em seguida, chama IDataAdviseHolder::EnumAdvise para implementar IDataObject::EnumDAdvise.

Adicionar mais conexões de consultoria enquanto o objeto enumerador está ativo tem um efeito indefinido na enumeração que resulta desse método.

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

IDataAdviseHolder

IDataObject::EnumDAdvise

Ienumstatdata