Compartir a través de

Función InstallLayoutOrTipUserReg

  • Artículo

Habilita los diseños de teclado o los servicios de texto especificados para el usuario especificado.

Sintaxis

BOOL CALLBACK InstallLayoutOrTipUserReg(
  _In_opt_ LPCWSTR pszUserReg,
  _In_opt_ LPCWSTR pszSystemReg,
  _In_opt_ LPCWSTR pszSoftwareReg,
  _In_     LPCWSTR psz,
  _In_     DWORD   dwFlags
);

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.

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 siguientes identificadores 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_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 y servicios de texto actuales.
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.
FASE
 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. En el ejemplo siguiente se muestra cómo obtener un puntero a esta función.

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.

typedef HRESULT (
  WINAPI *PTF_ INSTALLLAYOUTORTIPUSERREG)(LPCWSTR pszUserReg, 
  LPCWSTR pszSystemReg, 
  LPCWSTR pszSoftwareReg, 
  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_ INSTALLLAYOUTORTIPUSERREG pfnInputLayoutOrTipUserReg;
    
    pfnInputLayoutOrTipUserReg = (PTF_ INSTALLLAYOUTORTIPUSERREG)GetProcAddress(hInputDLL, "InputLayoutOrTipUserReg");

    if(pfnInputLayoutOrTipUserReg)
    {
        bRet = (*pfnInputLayoutOrTipUserReg)(pszUserReg, pszSystemReg, pszSoftwareReg, 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