IStringTable::Enumerate method (mmc.h)
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 |