Método ITfDocumentMgr::CreateContext (msctf.h)

Artigo
08/24/2023

Cria um objeto de contexto.

Sintaxe

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

Parâmetros

[in] tidOwner

O identificador de cliente. Para um aplicativo, esse valor é fornecido por uma chamada anterior para ITfThreadMgr::Activate. Para um serviço de texto, esse valor é fornecido no método ITfTextInputProcessor::Activate do serviço de texto.

[in] dwFlags

Reservado, precisa ser zero.

[in] punk

Ponteiro para um objeto que dá suporte às interfaces ITextStoreACP ou ITfContextOwnerCompositionSink . Esse valor pode ser NULL.

[out] ppic

Endereço de um ponteiro ITfContext que recebe o contexto.

[out] pecTextStore

Ponteiro para um valor TfEditCookie que recebe um cookie de edição para o novo contexto. Esse valor identifica o contexto em vários métodos.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	Um ou mais parâmetros são inválidos.
E_OUTOFMEMORY	Ocorreu um erro de alocação de memória.
E_FAIL	Ocorreu um erro não especificado.

Comentários

Todas as referências ao parâmetro punk são lançadas quando o contexto é destruído ou quando o contexto é removido da pilha com o método ITfDocumentMgr::P op .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msctf.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional