Microsoft Speech Platform

ISpObjectTokenCategory::GetId

ISpObjectTokenCategory::GetId retrieves the category ID.

<pre IsFakePre="true" xmlns="http://www.w3.org/1999/xhtml"> <strong>HRESULT GetId(</strong> <strong> LPWSTR </strong> **<em>ppszCoMemCategoryId</em> <strong>);</strong> </pre>

Parameters

• ppszCoMemCategoryId
  [in] The null-terminated string name of the current category. ppszCoMemCategoryId must be freed with CoTaskMemFree when no longer required.

Return Values

Example

The following code snippet retrieves CategoryId for SPCAT_VOICES.

`

// Declare local identifiers:
HRESULT                           hr = S_OK;
CComPtr<ISpObjectTokenCategory>   cpSpObjectTokenCategory;
WCHAR                             *cpwszOldID;

hr = SpGetCategoryFromId(SPCAT_VOICES, &cpSpObjectTokenCategory;);
if (SUCCEEDED (hr))
{
hr = cpSpObjectTokenCategory->GetId(&cpwszOldID;);
}
if (SUCCEEDED (hr))
{
CoTaskMemFree(cpwszOldID);
}