Compartilhar via


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

Obtém o objeto do provedor de funções especificado.

Sintaxe

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

Parâmetros

[in] clsid

CLSID do provedor de funções desejado. Pode ser o CLSID de um provedor de funções registrado para o thread de chamada ou um dos valores predefinidos a seguir.

Valor Significado
GUID_SYSTEM_FUNCTIONPROVIDER
Obtém o provedor de funções do sistema TSF.
GUID_APP_FUNCTIONPROVIDER
Obtém o provedor de funções implementado pelo aplicativo atual. Esse objeto não estará disponível se o aplicativo não se registrar como um provedor de funções.

[out] ppFuncProv

Ponteiro para uma interface ITfFunctionProvider que recebe o provedor de funções.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
O método foi bem-sucedido.
TF_E_NOPROVIDER
Nenhum provedor de funções correspondente a clsid estava disponível.
E_FAIL
GUID_SYSTEM_FUNCTIONPROVIDER foi solicitado, mas não pode ser obtido.

Comentários

Um provedor de funções é registrado chamando o método ITfSourceSingle::AdviseSingleSink gerenciador do TSF com IID_ITfFunctionProvider.

Requisitos

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

Confira também

ITfFunctionProvider

ITfSourceSingle::AdviseSingleSink

ITfThreadMgr

ITfThreadMgr::EnumFunctionProviders