SaveDefaultUserInputSettings-Funktion

Artikel
06/13/2023

Wendet die Benutzertastataturlayout- und Textdiensteinstellung auf die Standardstruktur des Benutzers an.

Syntax

BOOL CALLBACK SaveDefaultUserInputSettings(
  _In_ HWND hwndParent,
  _In_ HKEY hSourceRegKey
);

Parameter

hwndParent [in]: Das übergeordnete Fenster für das Warnungsdialogfeld. Das Warnungsdialogfeld wird nicht immer angezeigt und wird entsprechend angezeigt. Wenn dieser Parameter NULL ist, wird das Warnungsdialogfeld nicht angezeigt.
hSourceRegKey [in]: Der Stammregistrierungsschlüssel der zu kopierenden Benutzereinstellung.

Rückgabewert

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

Beispiele

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. Im folgenden Beispiel wird veranschaulicht, wie Sie einen Zeiger auf diese Funktion erhalten.

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 .

typedef HRESULT (WINAPI *PTF_ SAVEDEFAULTUSERINPUTSETTINGS)(HWND hwndParent, HKEY hSourceRegKey);

HMODULE hInputDLL = LoadLibrary(TEXT("input.dll"));
BOOL bRet = FALSE;

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ SAVEDEFAULTUSERINPUTSETTINGS pfnSaveDefaultUserInputSettings;
    
    pfnSaveDefaultUserInputSettings = (PTF_ SAVEDEFAULTUSERINPUTSETTINGS)GetProcAddress(hInputDLL, "SaveDefaultUserInputSettings ");

    if(pfnSaveDefaultUserInputSettings)
    {
        bRet = (*pfnSaveDefaultUserInputSettings)( hwndParent, hSourceRegKey);
    }

    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