ISpVoice::Skip (Windows CE 5.0)

Send Feedback

This method causes the voice to skip forward or backward the specified number of items within the text of the current speak call.

HRESULT Skip(  WCHAR* pItemType,  long lNumItems,  ULONG* pulNumSkipped);

Parameters

  • pItemType
    [in] Pointer to the type of item to skip. Currently "SENTENCE" is the only type supported.
  • lNumItems
    [in] Number of items to skip in the current speak request. If lNumItems is a positive number, the voice will skip forward. If it is a negative number, the voice will skip backward. If lNumItems is 0, the voice will skip back to the beginning of the current item.
  • pulNumSkipped
    [out] Pointer to the actual number of items skipped.

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
E_INVALIDARG pItemType is invalid or bad.
E_POINTER pulNumSkipped is invalid or bad.
SPERR_VOICE_PAUSED Voice is in a paused state and cannot be skipped.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sapi.h, Sapi.idl.
Link Library: Sapilib.lib.

See Also

ISpVoice | SAPI Interfaces

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.