Compartir a través de

Función InstallLayoutOrTip

  • Artículo

Habilita los diseños de teclado o los servicios de texto especificados.

Sintaxis

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

Parámetros

psz [in]

Cadena que representa la lista de diseño de teclado o la lista de perfiles de servicios de texto.

dwFlags [in]

Campo de bits que especifica las marcas siguientes:

Nota

Los identificadores siguientes no se definen en un archivo de encabezado público. Debe usar el valor hexadecimal o #define los identificadores. Por ejemplo, para usar ILOT_UNINSTALL debe incluir #define ILOT_UNINSTALL 0x00000001 en el código.

Valor Significado
ILOT_UNINSTALL
0x00000001
 Igual que ILOT_DISABLED.
ILOT_DEFPROFILE
0x00000002
 Establece el diseño o la sugerencia especificados como un elemento predeterminado.
ILOT_DEFUSER4
0x00000004
 Cambia la configuración de . Predeterminado.
ILOT_SYSLOCALE
0x00000008
 Sin usar.
ILOT_NOLOCALETOENUMERATE
0x00000010
 Sin usar.
ILOT_NOAPPLYTOCURRENTSESSION
0x00000020
 La configuración se guarda, pero no se aplica a la sesión actual.
ILOT_CLEANINSTALL
0x00000040
 Deshabilita todos los diseños de teclado actuales y servicios de texto.
ILOT_DISABLED
0x00000080
 Deshabilita el diseño de teclado y el servicio de texto especificados.

Valor devuelto

Código devuelto Descripción
TRUE
 La función se realizó correctamente.
FALSE
 Se ha producido un error no especificado.

Comentarios

El formato de cadena de la lista de diseño es:

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

El formato de cadena de la lista de perfiles de servicio de texto es:

<LangID 1>:{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx};

A continuación se muestra un ejemplo de un valor para el parámetro psz :

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

Ejemplos

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 incorrecto de LoadLibrary 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 correctamente archivos DLL con diferentes versiones de 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);
}

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