Share via


Note

Please see Azure Cognitive Services for Speech documentation for the latest supported speech solutions.

Microsoft Speech Platform

SpGetCategoryFromId

SpGetCategoryFromId creates an object of CLSID_SpObjectTokenCategory. This function assists in locating and creating an object token category without having to search or change the registry directly.

Found in: sphelper.h

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>SpGetCategoryFromId(</strong> <strong> const WCHAR</strong> *<em>pszCategoryId</em>, <strong> <a runat="server" href="jj127673(v=msdn.10).md">ISpObjectTokenCategory</a></strong> **<em>ppCategory</em>, <strong> BOOL</strong> <em>fCreateIfNotExist</em> = FALSE <strong>);</strong> </pre>

Parameters

  • pszCategoryId
    [in] The string indicating the CategoryId.
  • ppCategory
    [out] The token category of the object being created. It is created with CoCreateInstance and must be manually freed when no longer required.
  • fCreateIfNotExist
    [in] An optional parameter allowing the object to be created if one does not currently exist. The default is FALSE unless otherwise specified.

Return Values

Value Description
S_OK Function completed successfully.
FAILED (hr) Appropriate error message.