Expand Minimize

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.

MethodDescription
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

ObjIdl.h

IDL

ObjIdl.idl

IID

IID_IEnumString is defined as 00000101-0000-0000-C000-000000000046

 

 

Community Additions

ADD
Show:
© 2014 Microsoft