Méthode ITfThreadMgr ::GetFunctionProvider (msctf.h)

Obtient l’objet fournisseur de fonction spécifié.

Syntaxe

HRESULT GetFunctionProvider(
  [in]  REFCLSID            clsid,
  [out] ITfFunctionProvider **ppFuncProv
);

Paramètres

[in] clsid

CLSID du fournisseur de fonction souhaité. Il peut s’agir du CLSID d’un fournisseur de fonctions inscrit pour le thread appelant ou de l’une des valeurs prédéfinies suivantes.

Valeur Signification
GUID_SYSTEM_FUNCTIONPROVIDER
Obtient le fournisseur de fonction système TSF.
GUID_APP_FUNCTIONPROVIDER
Obtient le fournisseur de fonctions implémenté par l’application actuelle. Cet objet n’est pas disponible si l’application ne s’inscrit pas en tant que fournisseur de fonction.

[out] ppFuncProv

Pointeur vers une interface ITfFunctionProvider qui reçoit le fournisseur de fonctions.

Valeur retournée

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

Valeur Description
S_OK
La méthode a réussi.
TF_E_NOPROVIDER
Aucun clsid correspondant au fournisseur de fonction n’était disponible.
E_FAIL
GUID_SYSTEM_FUNCTIONPROVIDER a été demandé, mais ne peut pas être obtenu.

Remarques

Un fournisseur de fonctions s’inscrit en appelant la méthode ITfSourceSingle ::AdviseSingle du gestionnaire TSF avec IID_ITfFunctionProvider.

Configuration requise

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

Voir aussi

ITfFunctionProvider

ITfSourceSingle ::AdviseSinglesink

ITfThreadMgr

ITfThreadMgr ::EnumFunctionProviders