SetDefaultLayoutOrTip, fonction

Définit la disposition du clavier ou un service de texte spécifié comme élément d’entrée par défaut de l’utilisateur actuel.

Syntaxe

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

Paramètres

psz [in]

Chaîne qui représente une liste de dispositions de clavier ou une liste de profils de services de texte.

dwFlags [in]

Champ de bits qui spécifie les indicateurs suivants.

Remarque

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

Valeur	Signification
SDLOT_NOAPPLYTOCURRENTSESSION 0x00000001	Stocke le paramètre dans le Registre, mais ne met pas à jour le paramètre clavier d’exécution de la session active. Si le chemin d’accès de Registre de remplacement est défini dans SetDefaultLayoutOrTipUserReg, cet indicateur doit être défini.
SDLOT_APPLYTOCURRENTTHREAD 0x00000002	Applique immédiatement le paramètre sur le thread actif.

Valeur retournée

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 de profils de service de texte est :

<LangID 1> :{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}{xxxxxxxx-xxxx-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 GetProcAddress. L’exemple suivant montre comment obtenir un pointeur vers cette fonction.

typedef HRESULT (WINAPI *PTF_ SETDEFAULTLAYOUTORTIP)(LPCWSTR psz);

HMODULE hInputDLL = LoadLibrary(TEXT("input.dll"));
BOOL bRet = FALSE;

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ SETDEFAULTLAYOUTORTIP pfnSetDefaultLayoutOrTip;
    
    pfnSetDefaultLayoutOrTip = (PTF_ SETDEFAULTLAYOUTORTIP)GetProcAddress(hInputDLL, "SetDefaultLayoutOrTip");

    if(pfnSetDefaultLayoutOrTip)
    {
        bRet = (*pfnSetDefaultLayoutOrTip)(psz);
    }

    FreeLibrary(hInputDLL);
}

Configuration requise