EnumEnabledLayoutOrTip-Funktion

Artikel
06/12/2023

Listet alle aktivierten Tastaturlayouts oder Textdienste der angegebenen Benutzereinstellung auf.

Syntax

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

Parameter

pszUserReg [in, optional]: Der Registrierungspfad des Benutzers. Wenn dieser Parameter NULL ist, wird HKEY_CURRENT_USER verwendet.
pszSystemReg [in, optional]: Der Registrierungspfad des Systems. Wenn dieser Parameter NULL ist, wird HKEY_LOCAL_MACHINE\System verwendet.
pszSoftwareReg [in, optional]: Der Registrierungspfad der Software. Wenn dieser Parameter NULL ist, wird HKEY_LOCAL_MACHINE\Software verwendet.
pLayoutOrTipProfile [out]: Zeiger auf den Puffer, der das LAYOUTORTIPPROFILE-Array empfängt.
uBufLength [in]: Die Länge des Puffers, auf den pLayoutOrTipProfile verweist.

Rückgabewert

Wenn pLayoutOrTipProfileNULL ist, die Anzahl der Tastaturelemente, die in der Benutzereinstellung aktiviert sind; Andernfalls die Anzahl der Tastaturelemente, die in pLayoutOrTipProfile kopiert werden.

Für Sprachen des Eingabemethoden-Editors (IME) werden alle IMEs zurückgegeben, auch wenn nur ein IME aktiviert ist. Wenn ein Benutzer beispielsweise die CHT New Quick IME aktiviert hat, gibt die EnumEnabledLayoutOrTip-Funktion alle 5 CHT-IMEs zurück.

Bemerkungen

Es ist keine Importbibliothek verfügbar, die diese Funktion definiert. Daher muss mithilfe von LoadLibrary und GetProcAddress ein Zeiger auf diese Funktion abgerufen werden.

Hinweis

Die falsche Verwendung von LoadLibrary kann die Sicherheit Ihrer Anwendung beeinträchtigen, indem die falsche DLL geladen wird. Informationen zum ordnungsgemäßen Laden von DLLs mit verschiedenen Versionen von Microsoft Windows finden Sie unter Dynamic-Link Library Search Order (Dynamic Link Library Search Order ).

Die Definition von LAYOUTORTIPPROFILE lautet:

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;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
DLL	Input.dll

Freigeben über