Compartir a través de

Función EnumEnabledLayoutOrTip

  • Artículo

Enumera todos los diseños de teclado habilitados o servicios de texto de la configuración de usuario especificada.

Sintaxis

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

Parámetros

pszUserReg [in, opcional]

Ruta de acceso del Registro del usuario. Si este parámetro es NULL, se usa HKEY_CURRENT_USER.

pszSystemReg [in, opcional]

Ruta de acceso del Registro del sistema. Si este parámetro es NULL, se usa HKEY_LOCAL_MACHINE\System.

pszSoftwareReg [in, opcional]

Ruta de acceso del registro del software. Si este parámetro es NULL, se usa HKEY_LOCAL_MACHINE\Software.

pLayoutOrTipProfile [out]

Puntero al búfer que recibe la matriz LAYOUTORTIPPROFILE.

uBufLength [in]

Longitud del búfer al que apunta pLayoutOrTipProfile.

Valor devuelto

Si pLayoutOrTipProfile es NULL, el número de elementos de teclado habilitados en la configuración del usuario; de lo contrario, el número de elementos de teclado que se copian en pLayoutOrTipProfile.

En el caso de los idiomas del Editor de métodos de entrada (IME), se devuelven todas las IME, incluso cuando solo se habilita un IME. Por ejemplo, si un usuario tiene habilitado el nuevo IME rápido CHT, la función EnumEnabledLayoutOrTip devuelve todas las 5 IME de CHT.

Comentarios

No hay ninguna biblioteca de importación disponible que defina esta función, por lo que es necesario obtener un puntero a esta función mediante LoadLibrary y GetProcAddress.

Nota

El uso de LoadLibrary incorrectamente puede poner en peligro la seguridad de la aplicación cargando el archivo DLL incorrecto. Consulte Dynamic-Link Library Search Order (Orden de búsqueda de la biblioteca de vínculos dinámicos ) para obtener información sobre cómo cargar archivos DLL correctamente con diferentes versiones de Microsoft Windows.

La definición de LAYOUTORTIPPROFILE es:

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;

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
 Windows Server 2008 [solo aplicaciones de escritorio]
Archivo DLL
Input.dll