Поделиться через

Функция EnumEnabledLayoutOrTip

  • Статья

Перечисляет все включенные раскладки клавиатуры или текстовые службы указанного пользовательского параметра.

Синтаксис

UINT EnumEnabledLayoutOrTip(
  _In_opt_ LPCWSTR            pszUserReg,
  _In_opt_ LPCWSTR            pszSystemReg,
  _In_opt_ LPCWSTR            pszSoftwareReg,
  _Out_    LAYOUTORTIPPROFILE *pLayoutOrTipProfile,
  _In_     UINT               uBufLength
);

Параметры

pszUserReg [in, необязательный]

Путь к реестру пользователя. Если этот параметр имеет значение NULL, используется HKEY_CURRENT_USER.

pszSystemReg [in, необязательный параметр]

Путь к реестру системы. Если этот параметр имеет значение NULL, используется HKEY_LOCAL_MACHINE\System.

pszSoftwareReg [в, необязательно]

Путь к реестру программного обеспечения. Если этот параметр имеет значение NULL, используется HKEY_LOCAL_MACHINE\Software.

pLayoutOrTipProfile [out]

Указатель на буфер, который получает массив LAYOUTORTIPPROFILE.

uBufLength [in]

Длина буфера, на который указывает pLayoutOrTipProfile.

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

Если pLayoutOrTipProfile имеет значение NULL, количество элементов клавиатуры, включенных в параметре пользователя; в противном случае — количество элементов клавиатуры, которые копируются в pLayoutOrTipProfile.

Для языков редактора метода ввода (IME) возвращаются все IME, даже если включен только один IME. Например, если у пользователя включен быстрый IME CHT New, функция EnumEnabledLayoutOrTip возвращает все 5 CHT IME.

Комментарии

Нет доступной библиотеки импорта, определяющей эту функцию, поэтому необходимо получить указатель на эту функцию с помощью LoadLibrary и GetProcAddress.

Примечание

Неправильное использование LoadLibrary может поставить под угрозу безопасность приложения, загрузив неправильную библиотеку DLL. Сведения о том, как правильно загружать библиотеки DLL с различными версиями Microsoft Windows, см. в статье Порядок поиска библиотек динамической компоновки .

Определение LAYOUTORTIPPROFILE:

typedef struct tagLAYOUTORTIPPROFILE {
    DWORD  dwProfileType;       // InputProcessor or HKL 
#define LOTP_INPUTPROCESSOR 1
#define LOTP_KEYBOARDLAYOUT 2
    LANGID langid;              // language id 
    CLSID  clsid;               // CLSID of tip 
    GUID   guidProfile;         // profile description 
    GUID   catid;               // category of tip 
    DWORD  dwSubstituteLayout;  // substitute hkl 
    DWORD  dwFlags;             // Flags 
    WCHAR  szId[MAX_PATH];      // KLID or TIP profile for string 
} LAYOUTORTIPPROFILE;

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
DLL
Input.dll