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

Article
02/29/2024

Crée un objet de contexte.

Syntaxe

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

Paramètres

[in] tidOwner

Identificateur client. Pour une application, cette valeur est fournie par un appel précédent à ITfThreadMgr ::Activate. Pour un service de texte, cette valeur est fournie dans la méthode ITfTextInputProcessor ::Activate du service de texte.

[in] dwFlags

Réservé, doit être égal à zéro.

[in] punk

Pointeur vers un objet qui prend en charge les interfaces ITextStoreACP ou ITfContextOwnerCompositionSink . Cette valeur peut être NULL.

[out] ppic

Adresse d’un pointeur ITfContext qui reçoit le contexte.

[out] pecTextStore

Pointeur vers une valeur TfEditCookie qui reçoit un cookie de modification pour le nouveau contexte. Cette valeur identifie le contexte dans différentes méthodes.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Description
S_OK	La méthode a réussi.
E_INVALIDARG	Un ou plusieurs paramètres ne sont pas valides.
E_OUTOFMEMORY	Une erreur d’allocation de mémoire s’est produite.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Toutes les références au paramètre punk sont libérées lorsque le contexte est détruit ou lorsque le contexte est supprimé de la pile avec la méthode ITfDocumentMgr ::P op .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Msctf.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel