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]下列位的組合:
值 | 意義 |
---|---|
|
此設定檔不會出現在設定 UI 中。 |
|
此設定檔僅適用于本機進程。 |
|
此設定檔僅適用于本機執行緒。 |
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
發生未指定的錯誤。 |
|
一或多個參數無效。 |
需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |