ISpNotifyTranslator
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 converts a call to the ISpNotifySink::Notify method into the appropriate notification. The interface must be initialized before the ISpNotifySource::SetNotifySink method can be called, passing the translator object interface as the parameter.
Because ISpNotifySource supports most of the functionality of this interface, application writers will typically never need to use this interface. In fact, SAPI uses this interface to implement the various methods of ISpNotifySource. The method InitWin32Event supports the ability to initialize the translator with a specific event object, and so could be used for that purpose.
When to Implement
The only entity that implements this interface is SpNotifyTranslator.
Methods
The following table shows the methods for the ISpNotifyTranslator interface.
| Methods | Description |
|---|---|
Gets the Win32 event handle associated with the translator. |
|
Sets up this instance to send notifications using a standard C-style callback function. |
|
Enables an object derived from ISpNotifyCallback to receive notifications. |
|
Sets up the instance to send window messages to a specified window. |
|
Sets up a Win32 event object to be used by this instance. |
|
A blocking call that waits for a notification. |
Requirements
| Header | sapi.h, sapi.idl |
| Library | sapilib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |