Microsoft Speech SDK SAPI 5.1

---

SpGetSubTokenFromToken

SpGetSubTokenFromToken creates a subtoken from a token.

Found in: spddkhlp.h

SpGetSubTokenFromToken(
   ISpObjectToken   *pToken,
   const WCHAR      *pszSubKeyName,
   ISpObjectToken  **ppToken,
   BOOL              fCreateIfNotExist = FALSE
);

Parameters

pToken

[in] The object token from which to create the subtoken. If not present, this token will be created if fCreateIfNotExist is TRUE.

pszSubKeyName

[out] The name of the subtoken to use.

ppToken

[in] The newly created subtoken.

fCreateIfNotExist

[in] Optional Boolean indicating that the token is to be created if one does not currently exist. TRUE allows the creation. The default value FALSE does not.

Return values

Value	Description
S_OK	Function completed successfully.
E_POINTER	At least one of the pointers pToken, pszSubKeyName, or ppToken is invalid or bad.
FAILED (hr)	Appropriate error message.