Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

This method allows the recognition of patterns to be enabled or disabled, which could potentially be useful, for example, to enable certain voice tags in certain contexts.

Syntax 

HRESULT  EnableItem (
  SPRECOGNITIONMETHOD 
eRM,
  SPTYPEHEADER* 
psth,
  BOOL 
fEnable
);

Parameters

eRM

[in] Identifies which recognition method should be used.

psth

[out][in] Pointer to information that identifies the pattern.

Recognition method SPTYPEHEADER type

SPRM_CONTINUOUSDIGIT

SPT_NULL or ignored

Returns a global trained state.

SPRM_VOICETAG

SPT_DWORD
fEnable

[in] Set to FALSE to disable recognition of the tag in the current context. Set to TRUE to enable it.

Return Value

Value Description

S_OK

Success

E_NOTIMPL

Not implemented.

SPERR_NOT_FOUND

The sample identified by psthis not available on the system.

Otherwise, it returns an appropriate failure code from the return code list.

Remarks

The default behavior of the lexicon is to have all trained words enabled for the current context. Also, after a word is newly trained, it is always in the enabled state.

Note:
Please contact Microsoft before implementing this function.

Requirements

Header itspeech.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Smartphone 2002 and later

See Also