Metodo ITfInputProcessorProfileMgr::ActivateProfile (msctf.h)

Articolo
03/13/2024

Il metodo ITfInputProcessorProfileMgr::ActivateProfile attiva il profilo o il layout della tastiera del servizio di testo specificato.

Sintassi

HRESULT ActivateProfile(
  [in] DWORD    dwProfileType,
  [in] LANGID   langid,
  [in] REFCLSID clsid,
  [in] REFGUID  guidProfile,
  [in] HKL      hkl,
  [in] DWORD    dwFlags
);

Parametri

[in] dwProfileType

[in] Tipo di questo profilo. Si tratta di uno di questi valori.

Valore	Significato
TF_PROFILETYPE_INPUTPROCESSOR	Si tratta di un servizio di testo.
TF_PROFILETYPE_KEYBOARDLAYOUT	Si tratta di un layout della tastiera.

[in] langid

[in] ID lingua del profilo da attivare.

[in] clsid

[in] CLSID del servizio di testo del profilo da attivare. Deve essere CLSID_NULL se dwProfileType è TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] guidProfile

[in] GuidProfile del profilo da attivare. Deve essere GUID_NULL se dwProfileType è TF_PROFILETYPE_KEYBOARDLAYOUT.

[in] hkl

[in] Handle del layout della tastiera. Deve essere NULL se dwProfileType è TF_PROFILETYPE_INPUTPROCESSOR.

[in] dwFlags

Combinazione dei bit seguenti:

Valore	Significato
TF_IPPMF_FORPROCESS	Attivare questo profilo per tutti i thread nel processo.
TF_IPPMF_FORSESSION	Attivare questo profilo per tutti i thread nel desktop corrente.
TF_IPPMF_ENABLEPROFILE	Aggiornare il Registro di sistema per abilitare questo profilo per questo utente.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	Se la lingua di input corrente non corrisponde alla lingua del profilo richiesto, TSF contrassegna questo profilo da attivare quando viene cambiata la lingua di input richiesta. Se questo flag è disattivato e la lingua di input corrente non corrisponde, questo metodo ha esito negativo.

Valore restituito

Questo metodo può restituire uno di questi valori.

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

Requisiti

Requisito	Valore
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

Vedi anche

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile

Condividi tramite