ISpObjectToken::GetCategory (Windows Embedded CE 6.0)

1/6/2010

This method gets the category for a specified token, if one is available.

Syntax

HRESULT GetCategory(
  ISpObjectTokenCategory** ppTokenCategory
);

ppTokenCategory
[out] Address of a pointer to the ISpObjectTokenCategory interface for the token. The object must be freed when no longer required.

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.