IEnumString interface
Enumerate strings. LPWSTR is the type that indicates a pointer to a zero-terminated string of wide, or Unicode, characters.
When to implement
It is usually not necessary to implement this interface unless you have use for a custom string enumerator. A system implementation in the bind context object that exposes the IBindCtx interface also contains an implementation of IEnumString. IBindCtx::EnumObjectParam returns a pointer to this IEnumString interface on an enumerator that can return the keys of the bind context's string-keyed table of pointers.
When to use
Call the methods of IEnumString to enumerate through a set of strings.
Members
The IEnumString interface inherits from the IUnknown interface. IEnumString also has these types of members:
Methods
The IEnumString interface has these methods.
| Method | Description |
|---|---|
| Clone |
Creates a new enumerator that contains the same enumeration state as the current one. |
| Next |
Retrieves the specified number of items in the enumeration sequence. |
| Reset |
Resets the enumeration sequence to the beginning. |
| Skip |
Skips over the specified number of items in the enumeration sequence. |
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps | Windows Store apps] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps | Windows Store apps] |
|
Header |
|
|
IDL |
|
|
IID |
IID_IEnumString is defined as 00000101-0000-0000-C000-000000000046 |