Compartilhar via


Método IOleContainer::EnumObjects (oleidl.h)

Enumera os objetos no contêiner atual.

Sintaxe

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Parâmetros

[in] grfFlags

Especifica quais objetos em um contêiner devem ser enumerados, conforme definido na enumeração OLECONTF.

[out] ppenum

Um ponteiro para uma variável de ponteiro IEnumUnknown que recebe o ponteiro de interface para o objeto enumerador. Sempre que um contêiner recebe uma chamada bem-sucedida para EnumObjects, ele deve aumentar a contagem de referência no ponteiro ppenum que o método retorna. É responsabilidade do chamador chamar IUnknown::Release quando terminar com o ponteiro. Se um erro for retornado, a implementação deverá definir ppenum como NULL.

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.
E_NOTIMPL
Não há suporte para enumeração de objeto.

Comentários

Um contêiner deve implementar EnumObjects para permitir que clientes programáticos descubram quais objetos ele contém. Esse método, no entanto, não é chamado em cenários de vinculação padrão.

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

Confira também

IEnumUnknown

Iolecontainer

Ioleitemcontainer

OLECONTF