Metodo ITfInputProcessorProfileMgr::RegisterProfile (msctf.h)

Articolo
08/24/2023

Il metodo ITfInputProcessorProfileMgr::RegisterProfile registra il servizio di testo e il profilo.

Sintassi

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
);

Parametri

[in] rclsid

[in] CLSID del servizio di testo.

[in] langid

[in] ID lingua del profilo.

[in] guidProfile

[in] GUID per identificare il profilo.

pchDesc

[in, size_is(cchDesc)] Descrizione del profilo.

[in] cchDesc

[in] Lunghezza di pchDesc.

pchIconFile

[in, size_is(cchFile] Percorso completo del file icona.

[in] cchFile

[in] Lunghezza di pchIconFile.

[in] uIconIndex

[in] Indice icona del file icona per questo profilo.

[in] hklsubstitute

[in] Hkl sostitutivo di questo profilo.

[in] dwPreferredLayout

[in] Non utilizzato. deve essere 0.

[in] bEnabledByDefault

[in] True se il profilo è abilitato per impostazione predefinita.

[in] dwFlags

[in] Combinazione dei bit seguenti:

Valore	Significato
TF_RP_HIDDENINSETTINGUI	Questo profilo non verrà visualizzato nell'interfaccia utente dell'impostazione.
TF_RP_LOCALPROCESS	Questo profilo è disponibile solo nel processo locale.
TF_RP_LOCALTHREAD	Questo profilo è disponibile solo nel thread locale.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_FAIL	Si è verificato un errore non specificato.
E_INVALIDARG	Uno o più parametri non sono validi.

Requisiti


Client minimo supportato	Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll

Condividi tramite