Microsoft Speech Platform
ISpObjectTokenInit::InitFromDataKey
ISpObjectTokenInit::SetObjectToken initializes a token to use a specified datakey.
HRESULT InitFromDataKey(
const WCHAR *pszCategoryId,
const WCHAR *pszTokenId,
ISpDataKey *pDataKey
);
Parameters
- pszCategoryId
- [in] The null-terminated string name of the categoryId from which to create the token.
- pszTokenId
- [in] The null-terminated string name of the TokenId.
- pDataKey
- [in] Address of an ISpDataKey interface that specifies the system registry key from which to create the token.
Return values
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| E_POINTER | At least one of the parameters is invalid or bad. |
| SPERR_ALREADY_INITIALIZED | Token is already initialized. |
| SPERR_TOKEN_DELETED | Key has been deleted. |
| E_OUTOFMEMORY | Exceeded available memory. |
Remarks
Dynamic token enumerators can use this to create tokens under their token enumerator's token. Once created, this enables ISpDataKey::CreateKey to make a new data key, create a new object token, and then use InitFromDataKey.