IVTxtAttributes::EnabledGet

HRESULT EnabledGet(DWORD *dwEnabled);

Discovers whether voice text is enabled for a voice-text site. If voice text is disabled, no text-to-speech is played over the site.

· Returns NOERROR if successful, or one of these error values:

VTXTERR_INVALIDMODE
VTXTERR_INVALIDPARAM
VTXTERR_OUTOFMEM

dwEnabled

[out] TRUE if voice text is enabled for the site or FALSE if it is disabled.

Enabling or disabling voice text for a site affects all applications using a voice-text site.

Typically, an application disables voice text because the user does not want the computer to speak. You should involve the user when enabling or disabling voice text.

The enabled state for a site is saved between uses of the site, even if the user shuts down the computer in the meantime.