InstallLayoutOrTipUserReg-Funktion
Aktiviert die angegebenen Tastaturlayouts oder Textdienste für den angegebenen Benutzer.
Syntax
BOOL CALLBACK InstallLayoutOrTipUserReg(
_In_opt_ LPCWSTR pszUserReg,
_In_opt_ LPCWSTR pszSystemReg,
_In_opt_ LPCWSTR pszSoftwareReg,
_In_ LPCWSTR psz,
_In_ DWORD dwFlags
);
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.
-
psz [ In]
-
Eine Zeichenfolge, die die Tastaturlayoutliste oder die Profilliste der 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 definieren. Um beispielsweise ILOT _ UNINSTALL verwenden zu können, müssen Sie
#define ILOT_UNINSTALL 0x00000001in Ihren Code einschließen.Wert Bedeutung - ILOT _ DEINSTALLIEREN
- 0x00000001
Identisch mit ILOT _ DISABLED. - ILOT _ DEFPROFILE
- 0x00000002
Legt das angegebene Layout oder den angegebenen Tipp als Standardelement fest. - 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 Textdienst.
Rückgabewert
| Rückgabecode | Beschreibung |
|---|---|
|
Die Funktion war erfolgreich. |
|
Es ist ein unbekannter Fehler aufgetreten. |
Hinweise
Das Zeichenfolgenformat der Layoutliste lautet:
<LangID 1>:<SOLLD 1>; [ ...:
Das Zeichenfolgenformat der Textdienstprofilliste lautet:
<LangID 1>:{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx}{xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx};
Im Folgenden wird ein Beispiel für einen Wert für den psz-Parameter angezeigt:
"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 ist es erforderlich, mit LoadLibrary und GetProcAddresseinen Zeiger auf diese Funktion abzurufen. Im folgenden Beispiel wird veranschaulicht, wie sie einen Zeiger auf diese Funktion abrufen.
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 Suchreihenfolge der Dynamic Link Library.
typedef HRESULT (
WINAPI *PTF_ INSTALLLAYOUTORTIPUSERREG)(LPCWSTR pszUserReg,
LPCWSTR pszSystemReg,
LPCWSTR pszSoftwareReg,
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_ INSTALLLAYOUTORTIPUSERREG pfnInputLayoutOrTipUserReg;
pfnInputLayoutOrTipUserReg = (PTF_ INSTALLLAYOUTORTIPUSERREG)GetProcAddress(hInputDLL, "InputLayoutOrTipUserReg");
if(pfnInputLayoutOrTipUserReg)
{
bRet = (*pfnInputLayoutOrTipUserReg)(pszUserReg, pszSystemReg, pszSoftwareReg, psz, dwFlags);
}
FreeLibrary(hInputDLL);
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |
| DLL |
|