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

[入力]テキスト サービスの CLSID。

[in] langid

[入力]プロファイルの言語 ID。

[in] guidProfile

[入力]プロファイルを識別する GUID。

pchDesc

[in, size_is(cchDesc)]プロファイルの説明。

[in] cchDesc

[入力]pchDesc の長さ。

pchIconFile

[in, size_is(cchFile] アイコン ファイルの完全パス。

[in] cchFile

[入力]pchIconFile の長さ。

[in] uIconIndex

[入力]このプロファイルのアイコン ファイルのアイコン インデックス。

[in] hklsubstitute

[入力]このプロファイルの代替 hkl。

[in] dwPreferredLayout

[入力] 使用されていません。 これは 0 である必要があります。

[in] bEnabledByDefault

[入力]True を指定すると、このプロファイルが既定で有効になります。

[in] dwFlags

[入力]次のビットの組み合わせ。

値	説明
TF_RP_HIDDENINSETTINGUI	このプロファイルは、設定 UI には表示されません。
TF_RP_LOCALPROCESS	このプロファイルは、ローカル プロセスでのみ使用できます。
TF_RP_LOCALTHREAD	このプロファイルは、ローカル スレッドでのみ使用できます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
E_FAIL	未指定のエラーが発生しました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll