IEnumSTATDATA

9/8/2008

Essa interface é usada para enumerar por uma matriz de STATDATA estruturas, que contêm de consultoria informações conexão para um objeto de dados.

IEnumSTATDATA Tem os mesmos métodos como todas as interfaces enumerador: Próxima, Ignorar, Redefinir, e Clone.

Para obter informações gerais sobre esses métodos, consulte IEnumXXXX.

Quando a implementar

IEnumSTATDATA é implementada para enumerar de consultoria conexões. A maioria dos aplicativos não irá implementar este diretamente, mas irá usar a implementação OLE-provided. Ponteiros para essa implementação estão disponível de duas maneiras:

• Em um objeto de dados, chamar o CreateDataAdviseHolder função para get um ponteiro para o objeto OLE dados informar reservado e, em seguida, para implementar o IDataObject::EnumDAdvise método, chamar IDataAdviseHolder::EnumAdvise, que cria a objeto de enumeração e fornece um ponteiro para a implementação de IEnumSTATDATA.
• Em um objeto documento composto, chamar o CreateOleAdviseHolder função para um ponteiro para o objeto reservado informar OLE e, em seguida, para implementar get IOleObject::EnumAdvise, chamar IOleAdviseHolder::EnumAdvise, que cria a objeto de enumeração e fornece um ponteiro para a implementação de IEnumSTATDATA.

Quando usar

Recipientes geralmente chamar métodos que retornam um ponteiro para IEnumSTATDATA Portanto, o contêiner pode utilizar seus métodos para enumerar a de consultoria existente conexões e usar esse informações para instruir um objeto para versão cada do seu de consultoria conexões antes de fechar para baixo. O IDataObject::EnumDAdvise e IOleAdviseHolder::EnumAdvise Ambos os métodos fornecer um ponteiro para IEnumSTATDATA.

Os protótipos dos métodos são os seguintes.

HRESULT Next(
  ULONG celt,           
  STATDATA * rgelt,     
  ULONG * pceltFetched  
);
 
HRESULT Skip(
  ULONG celt  
);
 
HRESULT Reset(void)
 
HRESULT Clone(
  IEnumSTATDATA ** ppenum  
);

Métodos

A seguinte tabela mostra os métodos para esta interface no ordem alfabética.

Método	Descrição
Clone	Cria um copiar do atual estado da enumeração.
Próxima	Recupera um número especificado de itens na seqüência de enumeração.
Redefinir	Redefine a seqüência enumeração para o início.
Ignorar	Passa sobre um número especificado de itens na seqüência de enumeração.

Remarks

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requisitos

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IEnumSTATDATA::Clone
IEnumSTATDATA::Reset
IEnumSTATDATA::Skip
IOleAdviseHolder::EnumAdvise

Other Resources

Next