Share via

Функция 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
 Отключает указанную раскладку клавиатуры и службу текста.

Возвращаемое значение

Код возврата Описание
TRUE
 Функция выполнена успешно.
FALSE
 Произошла неизвестная ошибка.

Комментарии

Строковый формат списка макета:

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

Строковый формат списка текстовых профилей службы:

<LangID 1>:{xxxxxxx-xxxx-xxxx-xxxx-xxxxx}{xxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx};

Ниже приведен пример значения для параметра 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. Сведения о том, как правильно загружать библиотеки DLL с различными версиями Microsoft Windows, см. в статье Порядок поиска библиотек динамической компоновки .

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