Método IDataObject::EnumDAdvise (objidl.h)

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

Sintaxe

HRESULT EnumDAdvise(
  [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 definir *ppenumAdvise como NULL, 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. Outros valores possíveis incluem o seguinte.

Código de retorno Descrição
E_OUTOFMEMORY
Memória insuficiente disponível para a operação.
OLE_E_ADVISENOTSUPPORTED
Não há suporte para notificações de consultoria neste objeto.

Comentários

O objeto enumerador criado por esse método implementa a interface IEnumSTATDATA . IEnumSTATDATA permite a enumeração dos dados armazenados em uma matriz de estruturas STATDATA . Cada uma dessas estruturas fornece informações sobre uma única conexão de consultoria e inclui informações FORMATETC e ADVF , bem como o ponteiro para o coletor de consultoria e o token que representa a conexão.

Anotações aos Chamadores

É recomendável que você use o objeto titular de consultoria de dados OLE para lidar com conexões de consultoria. Com o ponteiro obtido por meio de uma chamada para CreateDataAdviseHolder, implementar IDataObject::EnumDAdvise torna-se uma questão simples de delegar a chamada para IDataAdviseHolder::EnumAdvise. Isso cria o enumerador e fornece o ponteiro para a implementação OLE de IEnumSTATDATA. Nesse ponto, você pode chamar seus métodos para enumerar as conexões de consultoria atuais.

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::EnumAdvise

Idataobject

Ienumstatdata