Compartilhar via

Método ITfInputProcessorProfileMgr::GetProfile (msctf.h)

  • Artigo

O método ITfInputProcessorProfileMgr::GetProfile retorna as informações do layout de perfil ou teclado do serviço de texto especificado em TF_INPUTPROCESSORPROFILE estrutura.

Sintaxe

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

Parâmetros

[in] dwProfileType

[in] O tipo desse perfil. Esse é um desses valores.

Valor Significado
TF_PROFILETYPE_INPUTPROCESSOR
 Esse é um serviço de texto.
TF_PROFILETYPE_KEYBOARDLAYOUT
 Este é um layout de teclado.

[in] langid

[in] A ID do idioma do perfil a ser ativado.

[in] clsid

[in] O CLSID do serviço de texto do perfil a ser ativado. Isso deve ser CLSID_NULL se dwProfileType for TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] O guidProfile do perfil a ser ativado. Isso deve ser GUID_NULL se dwProfileType for TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] O identificador do layout do teclado. Isso deve ser NULL se dwProfileType for TF_PROFILETYPE_INPUTPROCESSOR.

[out] pProfile

[out] O buffer a receber TF_INPUTPROCESSORPROFILE.

Retornar valor

Esse método pode retornar um desses valores.

Valor Descrição
S_OK
 O método foi bem-sucedido.
E_FAIL
 Ocorreu um erro não especificado.
E_INVALIDARG
 Um ou mais parâmetros são inválidos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho msctf.h
DLL Msctf.dll