IStringTable::Enumerate method (mmc.h)

Article
10/13/2021

The IStringTable::Enumerate method supplies a pointer to an IEnumString interface on an enumerator that can return the strings in a snap-in's string table. The IEnumString interface is a standard COM interface.

Syntax

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

Parameters

[out] ppEnum

The address of IEnumString* pointer variable that receives the interface pointer to the enumerator. If an error occurs, *ppEnum is set to NULL. If *ppEnum is non-NULL, MMC's implementation of IEnumString calls IUnknown::AddRef on the *ppEnum. The snap-in must call IUnknown::Release when the interface is no longer required.

Return value

This method can return one of these values.

Remarks

The returned IEnumString enumeration represents a snapshot of the collection of strings in the underlying string table the time that the enumeration was retrieved. Neither IEnumString::Reset, nor IEnumString::Clone takes a new snapshot of the collection.

The implementation of IEnumString uses the default OLE task memory allocator to allocate memory for the strings it returns.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	mmc.h
DLL	Mmcndmgr.dll