Ação RemoveFiles
A ação RemoveFiles remove os arquivos instalados anteriormente pela ação InstallFiles. Cada um desses arquivos é restrito por um link a uma entrada na tabela Component. Somente os arquivos com os componentes resolvidos para o estado msiInstallStateAbsent ou o estado msiInstallStateLocal se o componente estiver instalado localmente serão removidos.
Restrições de sequência
A ação InstallValidate precisa ser chamada antes da chamada a RemoveFiles. Se uma ação InstallFiles for usada, ela precisará aparecer após RemoveFiles.
Mensagens de 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. |
Comentários
A tabela RemoveFile poderá 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 estão instalados pela ação InstallFiles. Esses arquivos são especificados na tabela RemoveFile. Cada um desses arquivos é restrito por um link a uma entrada na tabela Component. Esses arquivos cujos componentes são resolvidos como qualquer estado de Action ativo (ou seja, não no estado Off ou Null) serão removidos se o arquivo existir no diretório especificado. Uma tentativa de remoção de arquivos especificados na tabela RemoveFile é feita 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 aquelas consultados 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 um texto localizado na coluna FileName da tabela RemoveFile.