Método IOleAdviseHolder::EnumAdvise (oleidl.h)

Artigo
08/25/2023

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

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 enumerador. Se esse parâmetro for NULL, atualmente não haverá conexões de consultoria no objeto ou ocorreu um erro. O titular da consultoria é responsável por incrementar a contagem de referência no ponteiro IEnumSTATDATA fornecido por esse método. É responsabilidade do chamador chamar IUnknown::Release quando terminar com o ponteiro.

Retornar valor

Esse método retorna S_OK com êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno	Descrição
E_FAIL	Falha na operação de enumeração.
E_NOTIMPL	IOleAdviseHolder::EnumAdvise não está implementado.

Comentários

IOleAdviseHolder::EnumAdvise cria um enumerador que pode ser usado para enumerar as conexões de consultoria estabelecidas de um objeto. O método fornece um ponteiro para a interface IEnumSTATDATA neste enumerador. As informações de conexão de consultoria para cada conexão são armazenadas na estrutura STATDATA e o enumerador deve ser capaz de enumerar essas estruturas.

Para esse método, os únicos membros de estrutura relevantes são pAdvise e dwConnection. Outros membros contêm informações de consultoria de dados. Quando você chama os métodos de enumeração e, enquanto uma enumeração está em andamento, o efeito de registrar ou revogar conexões de consultoria no que deve ser enumerado é indefinido.

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	oleidl.h