ISpObjectTokenCategory::SetId (SAPI 5.3)

Microsoft Speech API 5.3

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)