ISpDataKey
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This interface provides a mechanism for storing and retrieving string and other data. The main use for this interface is in conjunction with object tokens, which implement the ISpObjectToken interface (which inherits from ISpDataKey). For example, data can be stored in an object token representing a recognizer or TTS engine by using this interface.
When to Implement
- SpObjectToken is the standard class used for all existing SAPI object tokens. The data for each object token is stored in the registry.
- SpDataKey is a class that stores the data associated with the data key in the registry.
Applications or engines can implement this interface directly to provide a custom data key implementation.
Methods
The following table lists the methods for the ISpDataKey interface.
| Methods | Description |
|---|---|
Creates a new token subkey. |
|
Deletes a specified token key and all its descendants. |
|
Deletes a named value from the specified token. |
|
Enumerates the subkeys of the specified token. |
|
Enumerates the values of the specified token. |
|
Gets the binary data for a token. |
|
Gets the value information from a specified token. |
|
Gets the string value information from a specified token. |
|
Opens a specified token subkey. |
|
Sets the binary data for a token. |
|
Sets the value information for a specified token. |
|
Sets the string value information for a specified token. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |