Metodo ITfDocumentMgr::CreateContext (msctf.h)

Crea un oggetto contesto.

Sintassi

HRESULT CreateContext(
  [in]  TfClientId   tidOwner,
  [in]  DWORD        dwFlags,
  [in]  IUnknown     *punk,
  [out] ITfContext   **ppic,
  [out] TfEditCookie *pecTextStore
);

Parametri

[in] tidOwner

The client identifier. (Identificatore cliente.) Per un'applicazione, questo valore viene fornito da una chiamata precedente a ITfThreadMgr::Activate. Per un servizio di testo, questo valore viene fornito nel metodo ITfTextInputProcessor::Activate del servizio di testo.

[in] dwFlags

Riservato, deve essere zero.

[in] punk

Puntatore a un oggetto che supporta le interfacce ITextStoreACP o ITfContextOwnerCompositionSink . Questo valore può essere NULL.

[out] ppic

Indirizzo di un puntatore ITfContext che riceve il contesto.

[out] pecTextStore

Puntatore a un valore TfEditCookie che riceve un cookie di modifica per il nuovo contesto. Questo valore identifica il contesto in vari metodi.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_INVALIDARG
Uno o più parametri non sono validi.
E_OUTOFMEMORY
Si è verificato un errore di allocazione della memoria.
E_FAIL
Si è verificato un errore non specificato.

Commenti

Tutti i riferimenti al parametro punk vengono rilasciati quando il contesto viene eliminato definitivamente o quando il contesto viene rimosso dallo stack con il metodo ITfDocumentMgr::P op .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITextStoreACP

ITfContext

ITfContextOwnerCompositionSink

ITfDocumentMgr

ITfDocumentMgr::P op

ITfTextInputProcessor::Activate

ITfThreadMgr::Activate

TfEditCookie