SpFindBestToken (Windows Embedded CE 6.0)
1/6/2010
This function enumerates the tokens for the specified category, and finds the single token that best matches the supplied attributes.
Syntax
inline HRESULT SpFindBestToken(
const WCHAR* pszCategoryId,
const WCHAR* pszReqAttribs,
const WCHAR* pszOptAttribs,
ISpObjectToken** ppObjectToken
);
Parameters
- pszCategoryId
[in] Pointer to the identifier for the category.
- pszReqAttribs
[in] Pointer to required attributes for the token.
- pszOptAttribs
[in] Pointer to optional attributes for the token.
- ppObjectToken
[out] Address of a pointer to an object implementing ISpObjectToken.
Return Value
The following table shows the possible return values.
| Value | Description |
|---|---|
S_OK |
Function completed successfully. |
SPERR_NOT_FOUND |
No items match the given attributes. |
FAILED(hr) |
Appropriate error message. |
Requirements
| Header | sphelper.h |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |