Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITfInputProcessorProfileMgr::DeactivateProfile method

The ITfInputProcessorProfileMgr::DeactivateProfile method deactivates the specified text service's profile or keyboard layout.

Syntax


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

Parameters

dwProfileType [in]

[in] The type of this profile. This is one of these values.

ValueMeaning
TF_PROFILETYPE_INPUTPROCESSOR

This is a text service.

TF_PROFILETYPE_KEYBOARDLAYOUT

This is a keyboard layout.

 

langid [in]

[in] The language id of the profile to be activated.

clsid [in]

[in] The CLSID of the text service of the profile to be activated. This must be CLSID_NULL if dwProfileType is TF_PROFILETYPE_KEYBOARDLAYOUT.

guidProfile [in]

[in] The guidProfile of the profile to be activated. This must be GUID_NULL if dwProfileType is TF_PROFILETYPE_KEYBOARDLAYOUT.

hkl [in]

[in] The handle of the keyboard layout. This must be NULL if dwProfileType is TF_PROFILETYPE_INPUTPROCESSOR.

dwFlags [in]

The combination of the following bits:

ValueMeaning
TF_IPPMF_FORPROCESS

Deactivate this profile for all threads in the process.

TF_IPPMF_FORSESSION

Deactivate this profile for all threads in the current desktop.

TF_IPPMF_DISABLEPROFILE

 

Return value

This method can return one of these values.

ValueDescription
S_OK

The method was successful.

E_FAIL

An unspecified error occurred.

E_INVALIDARG

One or more parameters are invalid.

 

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 R2 [desktop apps | Windows Store apps]

Header

Msctf.h

IDL

Msctf.idl

DLL

Msctf.dll

See also

ITfInputProcessorProfileMgr
ITfInputProcessorProfileMgr::ActivateProfile

 

 

Show:
© 2017 Microsoft