Compartir a través de


Método IMoniker::Enum (objidl.h)

Recupera un puntero a un enumerador para los componentes de un moniker compuesto.

Sintaxis

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

Parámetros

[in] fForward

Si es TRUE, enumera los monikers de izquierda a derecha. Si es FALSE, enumera de derecha a izquierda.

[out] ppenumMoniker

Puntero a una variable de puntero IEnumMoniker que recibe el puntero de interfaz al objeto enumerador del moniker. Cuando se ejecuta correctamente, la implementación debe llamar a AddRef en el objeto enumerador. Es responsabilidad del autor de la llamada llamar a Release. Si se produce un error o si el moniker no tiene componentes enumerables, la implementación establece *ppnumMoniker en NULL.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY, E_UNEXPECTED y S_OK.

Comentarios

Este método debe proporcionar un puntero IEnumMoniker a un enumerador que pueda enumerar los componentes de un moniker. Por ejemplo, la implementación del método IMoniker::Enum para un moniker compuesto genérico crea un enumerador que puede determinar los monikers individuales que componen la composición, mientras que el método IMoniker::Enum para un moniker de archivos crea un enumerador que devuelve monikers que representan cada uno de los componentes de la ruta de acceso.

Notas a los autores de llamadas

Llame a este método para examinar los componentes que componen un moniker compuesto.

Notas para los implementadores

Si la nueva clase de moniker no tiene ninguna estructura interna perceptible, la implementación de este método simplemente puede devolver S_OK y establecerppnumMoniker en NULL.

Notas específicas de la implementación

Implementación Notas
Anti-moniker Este método devuelve S_OK y estableceppnumMoniker enNULL.
Moniker de clase Este método devuelve S_OK y estableceppnumMoniker enNULL.
Moniker de archivo Este método devuelve S_OK y estableceppnumMoniker enNULL.
Moniker compuesto genérico Si se ejecuta correctamente, este método devuelve S_OK y devuelve un enumerador que enumera los monikers de componentes que componen la composición; de lo contrario, el método devuelve E_OUTOFMEMORY.
Moniker de elemento Este método devuelve S_OK y estableceppnumMoniker enNULL.
Moniker de OBJREF Este método devuelve S_OK y estableceppnumMoniker enNULL.
Moniker de puntero Este método devuelve E_NOTIMPL.
Moniker de dirección URL Este método devuelve S_OK y estableceppnumMoniker enNULL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IEnumMoniker

Imoniker