EnumLayoutOrTipForSetup-Funktion

Artikel
06/13/2023

Listet die installierten Tastaturlayouts und Textdienste der Setup-Benutzeroberfläche oder OOBE auf.

Syntax

UINT CALLBACK EnumLayoutOrTipForSetup(
  _In_  LANGID      langid,
  _Out_ LAYOUTORTIP *pLayoutOrTip,
  _In_  UINT        uBufLength,
  _In_  DWORD       dwFlags
);

Parameter

langid [in]: Die Sprach-ID des elements, das aufgelistet werden soll.
pLayoutOrTip [out]: Zeiger auf den Puffer, der das Array von LAYOUTORTIP-Strukturen empfängt. Dies kann NULL sein, um die Anzahl der Elemente abzurufen.
uBufLength [in]: Die Länge des Puffers, auf den pLayoutOrTip verweist. Dies wird ignoriert, wenn pLayoutOrTipNULL ist.
dwFlags [in]: Wird nicht verwendet. Dies muss null sein.

Rückgabewert

Wenn pLayoutOrTipNULL ist, die Anzahl der Tastaturelemente, die im System registriert sind; andernfalls die Anzahl der Tastaturelemente, die in pLayoutOrTip kopiert werden.

Bemerkungen

Es ist keine Importbibliothek verfügbar, die diese Funktion definiert. Daher ist es erforderlich, einen Zeiger auf diese Funktion mithilfe von LoadLibrary und GetProcAddress abzurufen.

Hinweis

Die falsche Verwendung von LoadLibrary kann die Sicherheit Ihrer Anwendung gefährden, indem die falsche DLL geladen wird. Informationen zum ordnungsgemäßen Laden von DLLs mit verschiedenen Versionen von Microsoft Windows finden Sie unter Suchreihenfolge der Dynamic-Link-Bibliothek .

Die Definition von LAYOUTORTIP lautet:

typedef struct tagLAYOUTORTIP {
    DWORD dwFlags;
#define LOT_DEFAULT    0x0001 // If this is on, this is a default item. 
#define LOT_DISABLED   0x0002 // if this is on, this is not enabled. 
    WCHAR szId[MAX_PATH]; // Id of the keyboard item in the string format. 
    WCHAR szName[MAX_PATH]; // The description of the keyboard item. 
} LAYOUTORTIP;

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