IEnumString (Compact 2013)
3/26/2014
This interface enumerates strings. The LPWSTR data type indicates a pointer to a zero-terminated string of wide, or Unicode, characters.
IEnumString has the same methods as all enumerator interfaces: Next, Skip, Reset, and Clone. For general information on these methods, refer to IEnumXXXX.
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.
The IBindCtx::EnumObjectParam method 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.
Methods
The following table shows the methods for this interface in vtable order.
IUnknown method |
Description |
|---|---|
Returns pointers to supported interfaces. |
|
Increments reference count. |
|
Decrements reference count. |
Method |
Description |
|---|---|
Retrieves a specified number of items in the enumeration sequence. |
|
Skips a specified number of items in the enumeration sequence. |
|
Resets the enumeration sequence to the beginning. |
|
Creates another enumerator that contains the same enumeration state as the current one. |
Remarks
To determine whether the platform supports this interface, see Determining Supported COM APIs.
Requirements
Header |
objidl.h, |
Library |
ole32.lib, |