ITfInputProcessorProfileMgr：：RegisterProfile 方法 (msctf.h)

ITfInputProcessorProfileMgr：：RegisterProfile方法會註冊文字服務和設定檔。

語法

HRESULT RegisterProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
       const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
       const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex,
  [in] HKL         hklsubstitute,
  [in] DWORD       dwPreferredLayout,
  [in] BOOL        bEnabledByDefault,
  [in] DWORD       dwFlags
);

參數

[in] rclsid

[in]文字服務的 CLSID。

[in] langid

[in]設定檔的語言識別項。

[in] guidProfile

[in]要識別設定檔的 GUID。

pchDesc

[in， size_is (cchDesc) ]設定檔的描述。

[in] cchDesc

[in]pchDesc 的長度。

pchIconFile

[in， size_is (cchFile]圖示檔的完整路徑。

[in] cchFile

[in]pchIconFile 的長度。

[in] uIconIndex

[in]此設定檔之圖示檔的圖示索引。

[in] hklsubstitute

[in]這個設定檔的替代 hkl。

[in] dwPreferredLayout

[in] 未使用。 這必須是 0。

[in] bEnabledByDefault

[in]如果預設會啟用此設定檔，則為 True。

[in] dwFlags

[in]下列位的組合：

值	意義
TF_RP_HIDDENINSETTINGUI	此設定檔不會出現在設定 UI 中。
TF_RP_LOCALPROCESS	此設定檔僅適用于本機進程。
TF_RP_LOCALTHREAD	此設定檔僅適用于本機執行緒。

傳回值

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

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

需求

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