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

Artículo
03/05/2024

Crea un objeto de contexto.

Sintaxis

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

Parámetros

[in] tidOwner

El identificador del cliente. Para una aplicación, este valor se proporciona mediante una llamada anterior a ITfThreadMgr::Activate. Para un servicio de texto, este valor se proporciona en el servicio de texto ITfTextInputProcessor::Activate método.

[in] dwFlags

Reservado, debe ser 0.

[in] punk

Puntero a un objeto que admite las interfaces ITextStoreACP o ITfContextOwnerCompositionSink . Este valor puede ser NULL.

[out] ppic

Dirección de un puntero ITfContext que recibe el contexto.

[out] pecTextStore

Puntero a un valor tfEditCookie que recibe una cookie de edición para el nuevo contexto. Este valor identifica el contexto en varios métodos.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	Uno o varios parámetros no son válidos.
E_OUTOFMEMORY	Error de asignación de memoria.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Todas las referencias al parámetro punk se liberan cuando se destruye el contexto o cuando se quita el contexto de la pila con el método ITfDocumentMgr::P op .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional