SpCreateNewTokenEx (By Category ID) (Windows CE 5.0)
This function creates a new token using the category identifier and a token name. It subsequently completes the information with the helper function SpSetCommonTokenData.
inline HRESULT SpCreateNewTokenEx(constWCHAR* pszCategoryId,constWCHAR* pszTokenKeyName,constCLSID* pclsid,constWCHAR* pszLangIndependentName,LANGIDlangid,constWCHAR* pszLangDependentName,ISpObjectToken** ppToken,ISpDataKey** ppDataKeyAttribs);
Parameters
- pszCategoryId
[in] Pointer to a category identifier. - pszTokenKeyName
[in, out] Pointer to a token name. On input, an optional token key name is provided, or NULL. On output, this parameter points to the provided name with "Tokens" appended before it. If NULL is furnished as an input, the output is a unique token key name generated by the function. - pclsid
[in] Pointer to the token identifier (in the form of a CLSID). - pszLangIndependentName
[in] Pointer to the language-independent name of the token. - langid
[in] Language identifier of the word. This value can be zero to indicate that the word can use any defined LANGID value. - pszLangDependentName
[in] Pointer to the language-dependent name of the token. - ppToken
[out] Address of a pointer to an object implementing ISpObjectToken. The token is created if it currently does not exist. - ppDataKeyAttribs
[in, out] Address of a pointer to an object implementing ISpDataKey that contains data attributes for the token. The key is created if it does not currently exist. This value can be NULL if a data key is not needed.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function completed successfully. |
| FAILED(hr) | Appropriate error message. |
Requirements
OS Versions: Windows CE .NET 4.1 and later.
Header: Sphelper.h.
Link Library: Sapilib.lib.
See Also
Send Feedback on this topic to the authors