TF_ES_* Constants

The following are constants used by the ITfContext::RequestEditSession method.

Constant/value Description
TF_ES_ASYNCDONTCARE
( 0 )
The edit session can occur synchronously or asynchronously, at the discretion of the manager. The manager will attempt to schedule a synchronous edit session for improved performance. This value cannot be combined with the TF_ES_ASYNC or TF_ES_SYNC values.
TF_ES_SYNC
( 0x1 )
The edit session must be synchronous or the request will fail (with TF_E_SYNCHRONOUS). This flag should only be used in documented situations (such as keystroke handling) where it can be expected to succeed. Otherwise the call will likely fail. This value cannot be combined with the TF_ES_ASYNCDONTCARE or TF_ES_ASYNC values.
TF_ES_READ
( 0x2 )
Requests read-only access to the context.
TF_ES_READWRITE
( 0x6 )
Requests read/write access to the context.
TF_ES_ASYNC
( 0x8 )
The edit session must be asynchronous or the request will fail. This value cannot be combined with the TF_ES_ASYNCDONTCARE or TF_ES_SYNC values.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Redistributable
TSF 1.0 on Windows 2000 Professional
Header
Msctf.h
IDL
Msctf.idl

See also

ITfContext::RequestEditSession