Partilhar via


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

O método IStringTable::Enumerate fornece um ponteiro para uma interface IEnumString em um enumerador que pode retornar as cadeias de caracteres na tabela de cadeia de caracteres de um snap-in. A interface IEnumString é uma interface COM padrão.

Sintaxe

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

Parâmetros

[out] ppEnum

O endereço da variável de ponteiro IEnumString* que recebe o ponteiro de interface para o enumerador. Se ocorrer um erro, *ppEnum será definido como NULL. Se *ppEnum não for NULL, a implementação de IEnumString do MMC chamará IUnknown::AddRef no *ppEnum. O snap-in deve chamar IUnknown::Release quando a interface não for mais necessária.

Valor retornado

Esse método pode retornar um desses valores.

Comentários

A enumeração IEnumString retornada representa uma instantâneo da coleção de cadeias de caracteres na tabela de cadeia de caracteres subjacente na hora em que a enumeração foi recuperada. Nem IEnumString::Reset nem IEnumString::Clone assumem uma nova instantâneo da coleção.

A implementação de IEnumString usa o alocador de memória de tarefa OLE padrão para alocar memória para as cadeias de caracteres retornadas.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h
DLL Mmcndmgr.dll

Confira também

IStringTable

IStringTable::FindString