DIF_FINISHINSTALL_ACTION

  • Artigo

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)

Confira também

SetupDiFinishInstallAction