Microsoft Speech Platform
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. |