A frequent OLE programming task is to recurrently traverse a sequence of items. OLE supports such enumerations through the use of interfaces provided by enumeration objects. The speech application programming interface (API) includes several enumeration objects that, together, provide four interfaces: IVCmdEnum, ISREnum, ISREnumSRShare, and ITTSEnum.
Each enumeration interface includes functions that are specific to the kind of item being enumerated. In addition, each interface includes the following core functions.
Interface | Description |
Clone | Returns another object containing the same enumeration state as the current one. |
Next | Retrieves the specified number of items in the enumeration sequence. |
Reset | Resets the enumeration sequence back to the beginning. |
Skip | Skips over the specified number of items in the enumeration sequence. |
For more information about enumeration objects and the core member functions, see the Microsoft Win32 Software Development Kit (SDK). For more information about the IVCmdEnum interface, see the section, "Voice Commands." For more information about the ISREnum and IEnumSRSHARE interfaces, see the section, "Low-Level Speech Recognition API." For more information about the ITTSEnum interface, see the section, "Low-Level Text-to-Speech API."