Metodo ITfDocumentMgr::CreateContext (msctf.h)

Articolo
03/05/2024

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