ITfInputProcessorProfiles：：AddLanguageProfile 方法 (msctf.h)

建立包含特定文字服務和特定語言標識碼的語言配置檔。

語法

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

參數

[in] rclsid

包含文字服務 CLSID。

[in] langid

包含 LANGID 值，指定新增文字服務之設定檔的語言識別碼。 如果包含 -1，文字服務就會新增至所有語言。

[in] guidProfile

包含識別語言配置檔的 GUID 值。 這是使用中配置檔時 ，ITfInputProcessorProfiles：：GetActiveLanguageProfile 取得的值。

[in] pchDesc

WCHAR 緩衝區的指標，其中包含配置檔中文字服務的描述字串。 這是語言列中顯示的文字服務名稱。

[in] cchDesc

包含 pchDesc 中描述字串的長度，以字元為單位。 如果這包含 -1， 則 pchDesc 會假設為 NULL 終止的字串。

[in] pchIconFile

WCHAR 緩衝區的指標，其中包含要顯示在配置檔中文字服務語言列中之圖示之檔案的路徑和檔名。 此檔案可以是可執行檔 (.exe) 、DLL (.dll) 或圖示 (.ico) 檔案。

此參數是選擇性的，可以是 NULL。 在此情況下，文字服務會顯示預設圖示。

[in] cchFile

包含 pchIconFile 中圖示檔案字串的長度，以字元為單位。 如果這包含 -1，則會假設 pchIconFile 為 NULL 終止的字串。 如果 pchIconFile 為 NULL，則會忽略此參數。

[in] uIconIndex

包含 pchIconFile 中圖示的以零起始的索引，以在配置檔中文字服務的語言列中顯示。 如果 pchIconFile 為 NULL，則會忽略此參數。

傳回值

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

規格需求

另請參閱

ITfInputProcessorProfiles

ITfInputProcessorProfiles：：GetActiveLanguageProfile