Installlayoutortip-Funktion

Aktiviert die angegebenen Tastaturlayouts oder Text Dienste.

Syntax

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

Parameter

PSZ [ in]

Eine Zeichenfolge, die die Liste der Tastaturlayout-oder Text Dienst profile darstellt.

dwFlags [ in]

Ein Bitfeld, das die folgenden Flags angibt:

Hinweis

Die folgenden Bezeichner sind nicht in einer öffentlichen Header Datei definiert. Sie müssen entweder den Hexadezimalwert verwenden oder die Bezeichner # definieren. Wenn Sie z. b. " Ilot _ Uninstall " verwenden möchten, müssen Sie #define ILOT_UNINSTALL 0x00000001 in Ihren Code einschließen.

Wert Bedeutung
Ilot _
0x00000001
deinstallieren
Identisch mit " Ilot _ deaktiviert".
Ilot _ Defprofile
0x00000002
Legt das angegebene Layout oder den Tipp als Standardelement fest.
Ilot _ DEFUSER4
0x00000004
Ändert die Einstellung von. Vorgegebene.
Ilot _ Syslocale
0x00000008
Nicht verwendet.
Ilot _ Nolocaletoenumerate
0x00000010
Nicht verwendet.
Ilot _ Noapplydecurrentsession
0x00000020
Die Einstellung wird gespeichert, aber nicht auf die aktuelle Sitzung angewendet.
Ilot _ Cleaninstall
0x00000040
Deaktiviert alle aktuellen Tastaturlayouts und Text Dienste.
Ilot _
0x00000080
deaktiviert
Deaktiviert das angegebene Tastaturlayout und den angegebenen Text Dienst.

Rückgabewert

Rückgabecode Beschreibung
Fall
Die Funktion war erfolgreich.
Alarm
Es ist ein unbekannter Fehler aufgetreten.

Bemerkungen

Das Zeichen folgen Format der Layoutliste lautet:

<langid 1>: <KLID 1>; [ ...:

Das Zeichen folgen Format der Text Dienst Profil Liste lautet:

<langid 1>: {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} {xxxxxxxx-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 Import Bibliothek verfügbar, die diese Funktion definiert. Daher ist es erforderlich, mithilfe von LoadLibrary und GetProcAddresseinen Zeiger auf diese Funktion zu erhalten.

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 in der Such Reihenfolge für die Dynamic Link Library .

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)
Nur Windows Vista [ -Desktop-Apps]
Unterstützte Mindestversion (Server)
Nur Windows Server 2008 [ -Desktop-Apps]
DLL
Input.dll