Compartilhar via


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

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

Confira também

Itextstoreacp

ITfContext

ITfContextOwnerCompositionSink

ITfDocumentMgr

ITfDocumentMgr::P op

ITfTextInputProcessor::Activate

ITfThreadMgr::Activate

TfEditCookie