Método IOleAdviseHolder::EnumAdvise (oleidl.h)
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 |
|---|---|
|
Falha na operação de enumeração. |
|
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 |