Helper SpFindBestToken (SAPI 5.3)

Microsoft Speech API 5.3

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)