Compartilhar via


Ação RemoveFiles

A ação RemoveFiles remove arquivos instalados anteriormente pela ação InstallFiles. Cada um desses arquivos é fechado por um link para uma entrada na tabela componente do. Somente os arquivos com componentes resolvidos para o estado msiInstallStateAbsent ou o msiInstallStateLocal estado se o componente estiver instalado localmente, serão removidos.

Restrições de sequência

A ação InstallValidate deve ser chamada antes de chamar RemoveFiles. Se uma ação InstallFiles for usada, ela deverá aparecer após RemoveFiles.

Mensagens ActionData

Campo Descrição dos dados de ação
[1] Identificador do arquivo removido.
[9] Identificador do diretório que contém o arquivo removido.

 

Observações

A tabela RemoveFile pode ser omitida do banco de dados do instalador se não houver arquivos diversos a serem removidos.

A ação RemoveFiles também pode remover arquivos especificados pelo autor que não são instalados pela ação InstallFiles. Esses arquivos são especificados na tabela RemoveFile. Cada um desses arquivos é fechado por um link para uma entrada na tabela componente do. Os arquivos cujos componentes são resolvidos para qualquer estado de Ação ativo (ou seja, não no estado Desativado ou Nulo) serão removidos se o arquivo existir no diretório especificado. A remoção de arquivos especificados na tabela RemoveFile é tentada quando o componente vinculado é instalado pela primeira vez, durante uma reinstalação e novamente quando o componente vinculado é removido.

A ação RemoveFiles também pode remover pastas. Uma pasta vazia será removida se o valor na coluna FileName da tabela RemoveFile for nulo.

Ao remover arquivos instalados anteriormente, a ação RemoveFiles consulta os mesmos campos nas mesmas tabelas que as consultadas pela ação InstallFiles com a exceção de que a tabela Media não é usada pela ação RemoveFiles.

O nome do arquivo de destino pode ser especificado em texto localizado na coluna FileName da tabela RemoveFile.