ITfInputProcessorProfileMgr::ActivateProfile-Methode (msctf.h)

Artikel
02/29/2024

Die ITfInputProcessorProfileMgr::ActivateProfile-Methode aktiviert das Profil- oder Tastaturlayout des angegebenen Textdiensts.

Syntax

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

Parameter

[in] dwProfileType

[in] Der Typ dieses Profils. Dies ist einer dieser Werte.

Wert	Bedeutung
TF_PROFILETYPE_INPUTPROCESSOR	Dies ist ein Textdienst.
TF_PROFILETYPE_KEYBOARDLAYOUT	Dies ist ein Tastaturlayout.

[in] langid

[in] Die Sprach-ID des zu aktivierenden Profils.

[in] clsid

[in] Die CLSID des Textdiensts des zu aktivierenden Profils. Dies muss CLSID_NULL werden, wenn dwProfileType TF_PROFILETYPE_KEYBOARDLAYOUT ist.

[in] guidProfile

[in] Das guidProfile des zu aktivierenden Profils. Dies muss GUID_NULL werden, wenn dwProfileType TF_PROFILETYPE_KEYBOARDLAYOUT ist.

[in] hkl

[in] Der Griff des Tastaturlayouts. Dies muss NULL sein, wenn dwProfileType TF_PROFILETYPE_INPUTPROCESSOR ist.

[in] dwFlags

Die Kombination der folgenden Bits:

Wert	Bedeutung
TF_IPPMF_FORPROCESS	Aktivieren Sie dieses Profil für alle Threads im Prozess.
TF_IPPMF_FORSESSION	Aktivieren Sie dieses Profil für alle Threads auf dem aktuellen Desktop.
TF_IPPMF_ENABLEPROFILE	Aktualisieren Sie die Registrierung, um dieses Profil für diesen Benutzer zu aktivieren.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	Wenn die aktuelle Eingabesprache nicht mit der Sprache des angeforderten Profils übereinstimmt, markiert TSF dieses Profil, das aktiviert wird, wenn die angeforderte Eingabesprache gewechselt wird. Wenn dieses Flag deaktiviert ist und die aktuelle Eingabesprache nicht übereinstimmt, schlägt diese Methode fehl.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Das Sprachprofil ist nicht aktiviert.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msctf.dll

Weitere Informationen

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile

Freigeben über