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

Artigo
08/24/2023

O método ITfInputProcessorProfileMgr::RegisterProfile registra o serviço de texto e o perfil.

Sintaxe

HRESULT RegisterProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
       const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
       const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex,
  [in] HKL         hklsubstitute,
  [in] DWORD       dwPreferredLayout,
  [in] BOOL        bEnabledByDefault,
  [in] DWORD       dwFlags
);

Parâmetros

[in] rclsid

[in] CLSID do serviço de texto.

[in] langid

[in] A ID do idioma do perfil.

[in] guidProfile

[in] O GUID para identificar o perfil.

pchDesc

[in, size_is(cchDesc)] A descrição do perfil.

[in] cchDesc

[in] O comprimento de pchDesc.

pchIconFile

[in, size_is(cchFile] O caminho completo do arquivo de ícone.

[in] cchFile

[in] O comprimento de pchIconFile.

[in] uIconIndex

[in] O índice de ícone do arquivo de ícone para esse perfil.

[in] hklsubstitute

[in] O hkl substituto desse perfil.

[in] dwPreferredLayout

[in] Não é usado. isso deve ser 0.

[in] bEnabledByDefault

[in] True se esse perfil estiver habilitado por padrão.

[in] dwFlags

[in] A combinação dos seguintes bits:

Valor	Significado
TF_RP_HIDDENINSETTINGUI	Esse perfil não aparecerá na interface do usuário de configuração.
TF_RP_LOCALPROCESS	Esse perfil está disponível apenas no processo local.
TF_RP_LOCALTHREAD	Esse perfil está disponível apenas no thread local.

Valor retornado

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


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

Share via