Partager via

Fonction EnumEnabledLayoutOrTip

  • Article

Énumère toutes les dispositions de clavier ou services de texte activés du paramètre utilisateur spécifié.

Syntaxe

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

Paramètres

pszUserReg [in, facultatif]

Chemin du Registre de l’utilisateur. Si ce paramètre a la valeur NULL, HKEY_CURRENT_USER est utilisé.

pszSystemReg [in, facultatif]

Chemin d’accès au Registre du système. Si ce paramètre a la valeur NULL, HKEY_LOCAL_MACHINE\System est utilisé.

pszSoftwareReg [in, facultatif]

Chemin d’accès au Registre du logiciel. Si ce paramètre a la valeur NULL, HKEY_LOCAL_MACHINE\Software est utilisé.

pLayoutOrTipProfile [out]

Pointeur vers la mémoire tampon qui reçoit le tableau LAYOUTORTIPPROFILE.

uBufLength [in]

Longueur de la mémoire tampon pointée vers pLayoutOrTipProfile.

Valeur retournée

Si pLayoutOrTipProfile a la valeur NULL, le nombre d’éléments de clavier activés dans le paramètre utilisateur ; sinon, le nombre d’éléments de clavier copiés dans pLayoutOrTipProfile.

Pour les langages IME (Input Method Editor), tous les IME sont retournés, même quand un seul IME est activé. Par exemple, si le Nouvel IME rapide CHT est activé pour un utilisateur, la fonction EnumEnabledLayoutOrTip retourne les 5 IME CHT.

Notes

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 .

La définition de LAYOUTORTIPPROFILE est :

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;

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