Helper SpFindBestToken (SAPI 5.4)

  • Article

Microsoft Speech API 5.4

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
S_OK
SPERR_NOT_FOUND
FAILED (hr)