ISpObjectToken::GetCategory
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method gets the category for a specified token, if one is available.
Syntax
HRESULT GetCategory(
ISpObjectTokenCategory** ppTokenCategory
);
Parameters
- ppTokenCategory
[out] Address of a pointer to the ISpObjectTokenCategory interface for the token. The object must be freed when no longer required.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
E_POINTER |
ppTokenCategory is invalid or bad. |
SPERR_UNINITIALIZED |
Token does not have a category. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |