The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITfContextOwnerCompositionServices::TerminateComposition method

Syntax

C++


HRESULT TerminateComposition(
  [in] ITfCompositionView *pComposition
);

Parameters

pComposition [in]: Pointer to a ITfCompositionView interface that represents the composition to terminate. If this value is NULL, all compositions in the context are terminated.

Return value

This method can return one of these values.

Value	Description
S_OK	The method was successful.
TF_E_DISCONNECTED	The context is not on a document stack.
TF_E_NOLOCK	A text service currently holds a lock on the document.
E_UNEXPECTED	This method was called during another composition operation.
E_FAIL	An unspecified error occurred.

Remarks

A text service uses ITfComposition::EndComposition to terminate a composition that it created.

If the context owner implements the text store, the context owner must be able to grant a synchronous write lock before calling this method.

This method also does the following:

For each composition terminated, ITfCompositionSink::OnCompositionTerminated is called for all installed composition advise sinks.
If the context owner installed a context owner composition advise sink, ITfContextOwnerCompositionSink::OnEndComposition is called for each terminated composition.
The GUID_PROP_COMPOSING property will be cleared for the text covered by each terminated composition.

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps \| Windows Store apps]
Minimum supported server	Windows 2000 Server [desktop apps \| Windows Store apps]
Redistributable	TSF 1.0 on Windows 2000 Professional
Header	Msctf.h
IDL	Msctf.idl
DLL	Msctf.dll