InstallLayoutOrTip 函式

  • 發行項

啟用指定的鍵盤配置或文字服務。

語法

BOOL CALLBACK InstallLayoutOrTip(
  _In_ LPCWSTR psz,
  _In_ DWORD   dwFlags
);

參數

psz [in]

表示鍵盤配置清單或文字服務配置檔案清單的字串。

dwFlags [in]

指定下列旗標的位欄位：

注意

公用標頭檔中未定義下列識別碼。 您必須使用十六進位值或#define識別碼。 例如，若要使用 ILOT_UNINSTALL 您必須包含在 #define ILOT_UNINSTALL 0x00000001 程式碼中。

值 意義
ILOT_UNINSTALL
0x00000001
 與 ILOT_DISABLED相同。
ILOT_DEFPROFILE
0x00000002
 將指定的版面配置或提示設定為預設專案。
ILOT_DEFUSER4
0x00000004
 變更 的設定。預設。
ILOT_SYSLOCALE
0x00000008
 未使用的。
ILOT_NOLOCALETOENUMERATE
0x00000010
 未使用的。
ILOT_NOAPPLYTOCURRENTSESSION
0x00000020
 設定會儲存，但不會套用至目前的會話。
ILOT_CLEANINSTALL
0x00000040
 停用所有目前的鍵盤配置和文字服務。
ILOT_DISABLED
0x00000080
 停用指定的鍵盤配置和文字服務。

傳回值

傳回碼 Description
TRUE
 函式成功。
FALSE
 發生未指定的錯誤。

備註

版面配置清單的字串格式為：

<LangID 1 > ： < KLID 1 > ;[...<LangID N > ： < KLID N>

文字服務配置檔案清單的字串格式為：

<LangID 1 > ：{xxxxxxxx-xxxx-xxxx-xxxx-xxx}{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx};

以下是 psz 參數值的範例：

"0x0407:0x00000407"
"0x0407:0x00000407;0x040C:0x0000040C"
"0x0407:0x00000407;0x0412:{A028AE76-01B1-46C2-99C4-ACD9858AE02F}{B5FE1F02-D5F2-4445-9C03-C568F23C99A1};0x040C:0x0000040C"

範例

沒有可定義此函式的匯入程式庫，因此必須使用 LoadLibrary 和 GetProcAddress取得此函式的指標。

注意

不正確地使用 LoadLibrary 可能會藉由載入錯誤的 DLL 來危害應用程式的安全性。 如需如何使用不同 Microsoft Windows 版本正確載入 DLL 的資訊，請參閱 動態連結程式庫搜尋順序 。

typedef HRESULT (WINAPI *PTF_ INSTALLLAYOUTORTIP)(LPCWSTR psz, DWORD dwFlasg);

HMODULE hInputDLL = LoadLibrary(TEXT("input.dll"));
BOOL bRet = FALSE;

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ INSTALLLAYOUTORTIP pfnInstallLayoutOrTip;
    
    pfnInstallLayoutOrTip = (PTF_ INSTALLLAYOUTORTIP)GetProcAddress(hInputDLL, "InstallLayoutOrTip");

    if(pfnInstallLayoutOrTip)
    {
        bRet = (*pfnInstallLayoutOrTip)(psz, dwFlags);
    }

    FreeLibrary(hInputDLL);
}

規格需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
DLL
Input.dll