InstallLayoutOrTip-Funktion

Artikel
06/13/2023

Aktiviert die angegebenen Tastaturlayouts oder Textdienste.

Syntax

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

Parameter

psz [in]

Eine Zeichenfolge, die die Tastaturlayoutliste oder die Profilliste für Textdienste darstellt.

dwFlags [in]

Ein Bitfeld, das die folgenden Flags angibt:

Hinweis

Die folgenden Bezeichner sind in einer öffentlichen Headerdatei nicht definiert. Sie müssen entweder den Hexadezimalwert verwenden oder die Bezeichner #define. Wenn Sie z. B. ILOT_UNINSTALL verwenden möchten, müssen Sie in Ihren Code einschließen #define ILOT_UNINSTALL 0x00000001 .

Wert	Bedeutung
ILOT_UNINSTALL 0x00000001	Identisch mit ILOT_DISABLED.
ILOT_DEFPROFILE 0x00000002	Legt das angegebene Layout oder die angegebene Spitze als Standardelement fest.
ILOT_DEFUSER4 0x00000004	Ändert die Einstellung von . Standard.
ILOT_SYSLOCALE 0x00000008	Nicht verwendet.
ILOT_NOLOCALETOENUMERATE 0x00000010	Nicht verwendet.
ILOT_NOAPPLYTOCURRENTSESSION 0x00000020	Die Einstellung wird gespeichert, aber nicht auf die aktuelle Sitzung angewendet.
ILOT_CLEANINSTALL 0x00000040	Deaktiviert alle aktuellen Tastaturlayouts und Textdienste.
ILOT_DISABLED 0x00000080	Deaktiviert das angegebene Tastaturlayout und den angegebenen Textdienst.

Rückgabewert

Rückgabecode	Beschreibung
TRUE	Die Funktion war erfolgreich.
FALSE	Es ist ein unbekannter Fehler aufgetreten.

Bemerkungen

Das Zeichenfolgenformat der Layoutliste lautet:

Das Zeichenfolgenformat der Textdienstprofilliste lautet:

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

Im Folgenden finden Sie ein Beispiel für einen Wert für den psz-Parameter :

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

Beispiele

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 ).

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

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