Metodo IMoniker::Enum (objidl.h)

Recupera un puntatore a un enumeratore per i componenti di un moniker composito.

Sintassi

HRESULT Enum(
  [in]  BOOL         fForward,
  [out] IEnumMoniker **ppenumMoniker
);

Parametri

[in] fForward

Se TRUE, enumera i moniker da sinistra a destra. Se FALSE, enumera da destra a sinistra.

[out] ppenumMoniker

Puntatore a una variabile puntatore IEnumMoniker che riceve il puntatore di interfaccia all'oggetto enumeratore per il moniker. In caso di esito positivo, l'implementazione deve chiamare AddRef sull'oggetto enumeratore. È responsabilità del chiamante chiamare Release. Se si verifica un errore o se il moniker non contiene componenti enumerabili, l'implementazione imposta *ppenumMoniker su NULL.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED e S_OK.

Commenti

Questo metodo deve fornire un puntatore IEnumMoniker a un enumeratore in grado di enumerare i componenti di un moniker. Ad esempio, l'implementazione del metodo IMoniker::Enum per un moniker composito generico crea un enumeratore che può determinare i singoli moniker che costituiscono il composito, mentre il metodo IMoniker::Enum per un moniker di file crea un enumeratore che restituisce moniker che rappresenta ognuno dei componenti nel percorso.

Note ai chiamanti

Chiamare questo metodo per esaminare i componenti che costituiscono un moniker composito.

Note per gli implementatori

Se la nuova classe moniker non ha una struttura interna riconoscibile, l'implementazione di questo metodo può semplicemente restituire S_OK e impostare ppenumMoniker su NULL.

Note specifiche dell'implementazione

Implementazione	Note
Anti-moniker	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.
Moniker di classe	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.
Moniker file	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.
Moniker composito generico	In caso di esito positivo, questo metodo restituisce S_OK e passa di nuovo un enumeratore che enumera i moniker dei componenti che costituiscono il composito; in caso contrario, il metodo restituisce E_OUTOFMEMORY.
Moniker elemento	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.
Moniker OBJREF	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.
Moniker puntatore	Questo metodo restituisce E_NOTIMPL.
Moniker URL	Questo metodo restituisce S_OK e imposta ppenumMoniker su NULL.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidl.h

Vedi anche

IEnumMoniker

Imoniker