共用方式為

iTfInputProcessorProfileMgr：：ActivateProfile 方法 (msctf.h)

  • 發行項

ITfInputProcessorProfileMgr：：ActivateProfile 方法會啟動指定的文字服務配置檔或鍵盤配置。

語法

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

參數

[in] dwProfileType

[in]這個配置檔的類型。 這是下列其中一個值。

值 意義
TF_PROFILETYPE_INPUTPROCESSOR
 這是文字服務。
TF_PROFILETYPE_KEYBOARDLAYOUT
 這是鍵盤配置。

[in] langid

[in]要啟動之配置文件的語言識別碼。

[in] clsid

[in]要啟動之配置檔之文字服務的CLSID。 如果 dwProfileType 是TF_PROFILETYPE_KEYBOARDLAYOUT，則必須CLSID_NULL這個值。

[in] guidProfile

[in]要啟動之配置檔的 guidProfile。 如果 dwProfileType 是TF_PROFILETYPE_KEYBOARDLAYOUT，則必須GUID_NULL這個值。

[in] hkl

[in]鍵盤配置的句柄。 如果 dwProfileType TF_PROFILETYPE_INPUTPROCESSOR，這必須是 NULL 。

[in] dwFlags

下列位的組合：

值 意義
TF_IPPMF_FORPROCESS
 針對進程中的所有線程啟用此配置檔。
TF_IPPMF_FORSESSION
 針對目前桌面中的所有線程啟用此配置檔。
TF_IPPMF_ENABLEPROFILE
 更新登錄以啟用此使用者的此配置檔。
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE
 如果目前的輸入語言與所要求的配置文件語言不符，TSF 會在切換要求的輸入語言時標示要啟動此配置檔。 如果此旗標已關閉，且目前的輸入語言不相符，則此方法會失敗。

傳回值

這個方法可以傳回下列其中一個值。

值 描述
S_OK
 此方法成功。
S_FALSE
 未啟用語言配置檔。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 一或多個參數無效。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll

另請參閱

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr：:D eactivateProfile