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 |
---|---|
|
函式成功。 |
|
發生未指定的錯誤。 |
備註
版面配置清單的字串格式為:
<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 |
|