SpEnumTokens

This function enumerates the tokens for the specified category. It retrieves the list in the form of an object implementing IEnumSpObjectTokens.

inline HRESULT SpEnumTokens(
  const WCHAR* pszCategoryId,
  const WCHAR* pszReqAttribs,
  const WCHAR* pszOptAttribs,
  IEnumSpObjectTokens** ppEnum
);

Parameters

  • pszCategoryId
    [in] Pointer to the identifier for the category.
  • pszReqAttribs
    [in] Pointer to required attributes for the tokens.
  • pszOptAttribs
    [in] Pointer to optional attributes for the tokens. The attributes are arranged in the same order as that used for the tokens listed in ppEnum.
  • ppEnum
    [out] Address of a pointer to an object implementing IEnumSpObjectTokens.

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

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.