ISpObjectTokenCategory::SetId (Windows Embedded CE 6.0)
1/6/2010
This method sets the category identifier. The client can call this method only once.
Syntax
HRESULT SetId(
const WCHAR* pszCategoryId,
BOOL fCreateIfNotExist
);
Parameters
- pszCategoryId
[in] Pointer to a null-terminated string specifying the category identifier. SAPI-defined categories are listed in Token Category identifiers.
- fCreateIfNotExist
[in] Value indicating if the method should create the category if it does not already exist. Set this value to TRUE to create the category, and to FALSE otherwise.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
SPERR_ALREADY_INITIALIZED |
Category interface is already initialized. |
E_INVALIDARG |
pszCategoryId is invalid or bad. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |