ITfInputProcessorProfileMgr::D eactivateProfile-Methode (msctf.h)

Artikel
03/04/2024

Die ITfInputProcessorProfileMgr::D eactivateProfile-Methode deaktiviert das Profil oder Tastaturlayout des angegebenen Textdiensts.

Syntax

HRESULT DeactivateProfile(
  [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 sein, wenn dwProfileType TF_PROFILETYPE_KEYBOARDLAYOUT ist.

[in] hkl

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

[in] dwFlags

Die Kombination der folgenden Bits:

Wert	Bedeutung
TF_IPPMF_FORPROCESS	Deaktivieren Sie dieses Profil für alle Threads im Prozess.
TF_IPPMF_FORSESSION	Deaktivieren Sie dieses Profil für alle Threads auf dem aktuellen Desktop.
TF_IPPMF_DISABLEPROFILE

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
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::ActivateProfile

Freigeben über