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

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.

Return Values

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.


OS Versions: Windows CE .NET 4.1 and later.
Header: sapi.h, sapi.idl.
Link Library: Sapilib.lib.

See Also

ISpObjectToken | SAPI Interfaces

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.