Método IStringTable::Enumerate (mmc.h)

El método IStringTable::Enumerate proporciona un puntero a una interfaz IEnumString en un enumerador que puede devolver las cadenas en la tabla de cadenas de un complemento. La interfaz IEnumString es una interfaz COM estándar.

Sintaxis

HRESULT Enumerate(
  [out] IEnumString **ppEnum
);

Parámetros

[out] ppEnum

La dirección de la variable de puntero IEnumString* que recibe el puntero de interfaz al enumerador. Si se produce un error, *ppEnum se establece en NULL. Si *ppEnum no es NULL, la implementación de MMC de IEnumString llama a IUnknown::AddRef en *ppEnum. El complemento debe llamar a IUnknown::Release cuando la interfaz ya no sea necesaria.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

La enumeración IEnumString devuelta representa una instantánea de la colección de cadenas de la tabla de cadenas subyacente la hora en que se recuperó la enumeración. Ni IEnumString::Reset ni IEnumString::Clone toman una nueva instantánea de la colección.

La implementación de IEnumString usa el asignador de memoria de tareas OLE predeterminado para asignar memoria para las cadenas que devuelve.

Requisitos

Consulte también

IStringTable

IStringTable::FindString