Microsoft Speech SDK Version 5.1

  • Article

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

Value Description
S_OK Function completed successfully.
SPERR_NOT_FOUND No items match the given attributes.
FAILED (hr) Appropriate error message.