iTfInputProcessorProfileMgr：：GetProfile 方法 (msctf.h)

ITfInputProcessorProfileMgr：：GetProfile 方法會傳回TF_INPUTPROCESSORPROFILE結構中指定之文字服務的配置檔或鍵盤配置資訊。

語法

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

參數

[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。

[out] pProfile

[out]要接收 TF_INPUTPROCESSORPROFILE的緩衝區。

傳回值

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

值	描述
S_OK	此方法成功。
E_FAIL	發生未指定的錯誤。
E_INVALIDARG	一或多個參數無效。

規格需求

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