Fonction InstallLayoutOrTip

Active les dispositions de clavier ou les services de texte spécifiés.

Syntaxe

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

Paramètres

psz [in]

Chaîne qui représente la liste de disposition du clavier ou la liste de profils des services de texte.

dwFlags [in]

Champ de bits qui spécifie les indicateurs suivants :

Notes

Les identificateurs suivants ne sont pas définis dans un fichier d’en-tête public. Vous devez utiliser la valeur hexadécimale ou #define les identificateurs. Par exemple, pour utiliser ILOT_UNINSTALL vous devez inclure #define ILOT_UNINSTALL 0x00000001 dans votre code.

Valeur Signification
ILOT_UNINSTALL
0x00000001
Identique à ILOT_DISABLED.
ILOT_DEFPROFILE
0x00000002
Définit la disposition ou le conseil spécifié comme élément par défaut.
ILOT_DEFUSER4
0x00000004
Modifie le paramètre de . Par défaut.
ILOT_SYSLOCALE
0x00000008
Inutilisé.
ILOT_NOLOCALETOENUMERATE
0x00000010
Inutilisé.
ILOT_NOAPPLYTOCURRENTSESSION
0x00000020
Le paramètre est enregistré, mais n’est pas appliqué à la session active.
ILOT_CLEANINSTALL
0x00000040
Désactive toutes les dispositions de clavier et services de texte actuels.
ILOT_DISABLED
0x00000080
Désactive la disposition du clavier et le service de texte spécifiés.

Valeur retournée

Code de retour Description
TRUE
La fonction a réussi.
FALSE
Une erreur non spécifiée s'est produite.

Notes

Le format de chaîne de la liste de disposition est le suivant :

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

Le format de chaîne de la liste des profils de service de texte est le suivant :

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

Voici un exemple de valeur pour le paramètre psz :

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

Exemples

Il n’existe aucune bibliothèque d’importation disponible qui définit cette fonction. Il est donc nécessaire d’obtenir un pointeur vers cette fonction à l’aide de LoadLibrary et de GetProcAddress.

Notes

L’utilisation incorrecte de LoadLibrary peut compromettre la sécurité de votre application en chargeant la DLL incorrecte. Pour plus d’informations sur la façon de charger correctement des DLL avec différentes versions de Microsoft Windows, consultez Ordre de recherche de bibliothèque de liens dynamiques .

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);
}

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
DLL
Input.dll