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 |
|---|---|
|
Memória insuficiente disponível para a operação. |
|
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 |