ISpShortcut::GetShortcuts (SAPI 5.3)

Speech API 5.3
Microsoft Speech API 5.3


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

HRESULT GetShortcuts(
   LANGID            LangID,
   SPSHORTCUTPAIRLIST    *pShortcutpairList


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

Return values

S_OKFunction completed successfully.


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.