Método Installer.EnableLog

O método EnableLog do objeto Installer habilita o registro em log do tipo de mensagem selecionado para todas as sessões de instalação subsequentes no espaço de processo atual.

Sintaxe

Installer.EnableLog(
  logMode,
  logFile
)

Parâmetros

logMode

Uma cadeia de caracteres obrigatória que contém letras que representam os tipos de mensagem a serem registrados. A cadeia de caracteres pode ser uma combinação dos valores a seguir.

Valor	Descrição
I	Mensagens apenas a fins informativos.
w	Mensagens de avisos não fatais.
e	Mensagens de erros que podem ser fatais.
f	Lista de arquivos em uso que precisam ser substituídos.
um	Notificação de início da ação.
r	Registro de dados de ação que contém conteúdo específico para a ação.
u	Mensagens de solicitação do usuário.
c	Parâmetros de inicialização da interface do usuário.
m	Mensagem de memória insuficiente.
v	Envia grandes quantidades de informações para o arquivo de log geralmente não úteis para os usuários. Pode ser usado para suporte.
p	Tabela de propriedades de despejo; "property = value" na terminação do mecanismo
+	Acrescente a um arquivo de log existente.
!	Libere cada linha para o arquivo de log.
x	Informações de depuração extra. Essa opção só está disponível com o Windows Server 2003.
o	Mensagens de espaço insuficiente em disco.

 

logFile

Cadeia de caracteres necessária que contém o caminho para o arquivo de log a ser criado. Use uma cadeia de caracteres vazia ("") para desligar o registro em log.

Valor retornado

Esse método não retorna um valor.

Comentários

O caminho para o local do arquivo de log já deve existir ao usar esse método. O instalador não cria a estrutura de diretório para o arquivo de log.

As opções de log definidas usando EnableLog substituem as configurações de política de log existentes do Windows Installer.

O registro em log substitui um arquivo de log existente por padrão. Você deve usar a letra '+' no modo de log para acrescentar a um arquivo de log existente.

A opção '!' não é recomendada porque pode retardar significativamente a instalação. Essa opção pode ser útil ao depurar uma instalação.

O script de exemplo a seguir liga o log detalhado para uma instalação. No final da instalação, o arquivo de log gerado estará em c:\temp\install.log.

    Dim Installer
    Set Installer = CreateObject("WindowsInstaller.Installer")
    Installer.EnableLog "voicewarmup", "c:\temp\install.log"
    Installer.InstallProduct "\\server\share\products\sample\sample.msi"

Requisitos

Requisito	Valor
Versão	Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL	Msi.dll
IID	O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046

Confira também

Registro em log do Windows Installer