Partilhar 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 Component. Somente os arquivos com componentes resolvidos para o estado msiInstallStateAbsent ou o estado msiInstallStateLocal se o componente for instalado localmente sã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

Domínio Descrição dos dados da ação
[1] Identificador do ficheiro removido.
[9] Identificador do diretório que contém o arquivo removido.

 

Comentários

A tabela RemoveFile pode ser omitida do banco de dados do instalador se não houver arquivos diversos para remover.

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 Component. Os arquivos cujos componentes são resolvidos para qualquer estado de ação ativo (ou seja, não no estado desativado ou nulo) sã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 null.

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 o da tabela Media não é usado pela ação RemoveFiles.

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