Share via


ISpObjectTokenCategory::SetId (SAPI 5.4)

Microsoft Speech API 5.4

ISpObjectTokenCategory::SetId

ISpObjectTokenCategory::SetId sets the category ID.

This method may be called only once. If called more than once, SPERR_ALREADY_INITIALIZED will return.

  
    HRESULT SetId(
   LPCWSTR       *pszCategoryId,
   BOOL           fCreateIfNotExist
);

Parameters

  • pszCategoryId
    [in] The null-terminated string name of category to set. SAPI-defined categories are listed in Token Category IDs.
  • fCreateIfNotExist
    [in] Indicates creating the category if one is not already present. TRUE creates the entry. FALSE does not.

Return values

Value
S_OK
SPERR_ALREADY_INITIALIZED
E_INVALIDARG
FAILED(hr)