Helper SpGetCategoryFromId (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

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

  
    SpGetCategoryFromId(
   const WCHAR              *pszCategoryId,
   ISpObjectTokenCategory **ppCategory,
   BOOL                     fCreateIfNotExist = FALSE
);

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
S_OK
FAILED (hr)