DIF_FINISHINSTALL_ACTION
Uma solicitação DIF_FINISHINSTALL_ACTION permite que um instalador execute ações de conclusão de instalação em um contexto de administrador interativo após a conclusão de todas as outras operações de instalação do dispositivo.
Quando enviado
Em Windows 8 e versões posteriores, as ações de conclusão de instalação não são executadas automaticamente como parte da instalação do dispositivo. Para concluir uma ação de conclusão da instalação do dispositivo, um usuário deve clicar em "Concluir a instalação do software do dispositivo" na Central de Ações para concluir a instalação.
Para obter mais informações, consulte Executando ações de Finish-Install.
No Windows 7, o processo de conclusão da instalação é executado somente no contexto de um usuário com credenciais de administrador em um dos seguintes momentos:
- Na próxima vez que um usuário que tiver credenciais de administrador fizer logon enquanto o dispositivo estiver anexado.
- Quando o dispositivo é reanexado.
- Quando o usuário seleciona Verificar se há alterações de hardware no Gerenciador de Dispositivos.
Se um usuário estiver conectado sem privilégios administrativos, o Windows solicitará ao usuário consentimento e credenciais para executar as ações de conclusão de instalação em um contexto de administrador.
Quem manipula
Co-instalador de classe |
Pode manipular |
Co-instalador de dispositivo |
Pode manipular |
Instalador de classe |
Pode manipular |
Entrada do instalador
DeviceInfoSet
Um identificador para o conjunto de informações do dispositivo que contém o dispositivo que está sendo instalado.
DeviceInfoData
Um ponteiro para uma estrutura SP_DEVINFO_DATA que representa o dispositivo que está sendo instalado.
Parâmetros de instalação do dispositivo
Há parâmetros de instalação do dispositivo (uma estrutura SP_DEVINSTALL_PARAMS ) associados a DeviceInfoData.
Parâmetros de instalação de classe
Nenhum
Saída do instalador
Parâmetros de instalação do dispositivo
Um instalador define o sinalizador DI_NEEDREBOOT se uma reinicialização do sistema for necessária para concluir suas ações de conclusão de instalação.
Valor retornado do instalador
Um instalador retorna um dos valores listados na tabela a seguir.
| Valor retornado | Significado |
|---|---|
ERROR_DI_DO_DEFAULT |
Instalador de classe: o instalador não tem nenhuma ação de conclusão de instalação, concluiu com êxito as ações de conclusão de instalação ou determinou que ele não pode concluir com êxito suas ações de instalação de término. A instalação do dispositivo deve executar o processamento padrão para a solicitação. Co-instalador: os co-instaladores não devem retornar esse código de erro. |
NO_ERROR |
Instalador de classe: um instalador de classe não deve retornar esse código de erro. Se um instalador de classe retornar esse código de erro, a instalação do dispositivo não executará o processamento padrão para a solicitação. Co-instalador: o instalador não tem ações de conclusão de instalação, concluiu com êxito as ações de conclusão de instalação ou determinou que não pode concluir com êxito suas ações de instalação de término. |
Código de erro do Win32 |
Instalador de classe ou coinstalador: o instalador encontrou um erro ao processar uma ação de conclusão de instalação e a instalação do dispositivo deve tentar concluir as ações de conclusão/instalação na próxima vez que o dispositivo for enumerado no contexto de um administrador. |
Manipulador de código DIF padrão
O Windows 7 usa SetupDiFinishInstallAction.
Não há manipulador de código DIF padrão em Windows 8 e versões posteriores, e SetupDiFinishInstallAction foi removido.
Comentários
Como a instalação do dispositivo não pode determinar de um código de retorno ERROR_DI_DO_DEFAULT ou um código de retorno NO_ERROR se uma ação de conclusão de instalação realmente foi bem-sucedida, o instalador deve notificar o usuário sobre o status de uma ação de concluir o instalador.
Para obter mais informações sobre ações de instalação de término, consulte How Device Installation Processes Finish-Install Actions and Implementing Finish-Install Actions.
Para obter informações gerais sobre códigos DIF, consulte Manipulando códigos DIF e Chamando manipuladores de código DIF padrão.
Requisitos
Versão |
Com suporte no Windows Vista por meio do Windows 7. |
Cabeçalho |
Setupapi.h (inclua Setupapi.h) |