IMoniker::Enum
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Thismethod enumera monikers componente.
Syntax
HRESULT Enum(
BOOL fForward,
IEnumMoniker** ppenumMoniker
);
Parameters
- fForward
[no] Boolean valor que está definido como TRUE para enumerar os identificadores de origem do esquerda para a direita ou FALSE para enumerar de direita para a esquerda.
ppenumMoniker
[out] Endereço do IEnumMonikervariável * pointer que recebe o ponteiro interface para o objeto enumerador para o moniker.Quando bem-sucedido, a implementação deve chamar o IUnknown::AddRef método sobre o objeto enumerador.
É responsabilidade do chamador para chamar o IUnknown::Release método.
Se ocorrer um erro ou se o moniker tiver não componentes enumeráveis, a implementação define *ppenumMoniker para NULL.
Return Value
O método suporta o padrão retornam valores E_OUTOFMEMORY e E_UNEXPECTED, bem como S_OK, que indica sucesso. S_OK é retornado, mesmo se o moniker não fornece um enumerador se ( ppenumMoniker é igual a NULL).
Remarks
IMoniker::Enum Deve fornecer um IEnumMoniker ponteiro para um enumerador que pode enumerar os componentes de um moniker.
Para a implementação de exemplo, o IMoniker::Enum método para um genérico composição moniker cria um enumerador que pode determinar o individual identificadores de origem que compõem a composição, enquanto o IMoniker::Enum método para um arquivo moniker cria um enumerador que retorna monikers representando cada um dos componentes no caminho.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Notas para chamadores
Chamar esse método para examinar os componentes que constituem uma composição moniker.
Notas para Implementers
Se a nova classe moniker não tiver nenhuma estrutura interna perceptível, sua implementação desse método pode simplesmente Retorna S_OK e definir ppenumMoniker para NULL.
Requirements
| 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 |