SpFindBestToken

SpFindBestToken enumerates the token category and finds the single best match (if any) based on the required and optional attributes.

Found in: sphelper.h

SpFindBestToken(
   const WCHAR       *pszCategoryId,
   const WCHAR       *pszReqAttribs,
   const WCHAR       *pszOptAttribs,
   ISpObjectToken   **ppObjectToken
);

Parameters

pszCategoryId

[in] The null-terminated string category ID on which to base the enumerations.

pszReqAttribs

[in] The null-terminated string of the required attributes for the token.

pszOptAttribs

[in] The null-terminated string of the optional attributes for the token. The order in which the tokens are listed in ppObjectToken is based on the order they match pszOptAttribs.

ppObjectToken

[out] The single best matched token found.

Return values