Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
::GetShortcuts
Collapse the table of content
Expand the table of content

ISpShortcut::GetShortcuts (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3

ISpShortcut::GetShortcuts

ISpShortcut::GetShortcuts returns all of the user shortcuts for a given language.


HRESULT GetShortcuts(
   LANGID            LangID,
   SPSHORTCUTPAIRLIST    *pShortcutpairList
);

Parameters

LangID
[in] The language the shortcuts are desired for (0 equals default).
pShortcutpairList
[in, out] The address of a pointer to a list of shortcut pairs.

Return values

ValueDescription
S_OKFunction completed successfully.

Remarks

The application must create a zero-initialized SPSHORTCUTPAIRLIST before calling GetShortcuts, using functions such as ZeroMemory or memset to do so. GetShortcuts creates a linked list of user shortcuts that start at the location pointed to by the pvBuffer member of SPSHORTCUTPAIRLIST. As long as the SPSHORTCUTPAIRLIST structure is still being used, the pvBuffer buffer should not be freed, because GetShortcuts reuses the buffer for reasons of efficiency, and reallocates storage when necessary.

When this structure is no longer needed, free the memory pointed to by pvBuffer by a call to CoTaskMemFree.

Show:
© 2015 Microsoft