SpGetDefaultTokenFromCategoryId (Windows CE 5.0)

Send Feedback

This function gets the default token for the specified category.

inline HRESULT SpGetDefaultTokenFromCategoryId(const WCHAR* pszCategoryId,ISpObjectToken** ppToken,  BOOL fCreateCategoryIfNotExist = TRUE);

Parameters

  • pszCategoryId
    [in] Pointer to the category identifier.
  • ppToken
    [out] Address of a pointer to an object implementing ISpObjectToken.
  • fCreateCategoryIfNotExist
    [in] An optional value indicating if the object is to be created if it does not already exist. Set this value to TRUE to create the object, and to FALSE otherwise. TRUE is the default.

Return Values

The following table shows the possible return values.

Value Description
S_OK Function completed successfully.
FAILED(hr) Appropriate error message.

Requirements

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

See Also

SAPI Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.