Função SaveDefaultUserInputSettings

Aplica o layout do teclado do usuário e a configuração do serviço de texto ao hive de usuário padrão.

Sintaxe

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

Parâmetros

hwndParent [in]

A janela pai da caixa de diálogo de aviso. A caixa de diálogo de aviso nem sempre é mostrada e aparece adequadamente. Se esse parâmetro for NULL, a caixa de diálogo de aviso não será mostrada.

hSourceRegKey [in]

A chave raiz do Registro da configuração do usuário a ser copiada.

Valor retornado

Código de retorno	Descrição
TRUE	A função foi bem-sucedida.
FALSE	Ocorreu um erro não especificado.

Exemplos

Não há nenhuma biblioteca de importação disponível que defina essa função, portanto, é necessário obter um ponteiro para essa função usando LoadLibrary e GetProcAddress. O exemplo a seguir demonstra como obter um ponteiro para essa função.

Observação

Usar LoadLibrary incorretamente pode comprometer a segurança do aplicativo carregando a DLL errada. Consulte a Ordem de Pesquisa da Biblioteca de Link Dinâmico para obter informações sobre como carregar corretamente DLLs com diferentes versões do Microsoft Windows.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
DLL	Input.dll