Função MsiEnableLogA (msi.h)

  • Artigo

A função MsiEnableLog define o modo de log para todas as instalações subsequentes iniciadas no processo de chamada.

Sintaxe

UINT MsiEnableLogA(
  [in] DWORD  dwLogMode,
  [in] LPCSTR szLogFile,
  [in] DWORD  dwLogAttributes
);

Parâmetros

[in] dwLogMode

Especifica o modo de log. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INSTALLLOGMODE_FATALEXIT
 Faz logoff da memória ou informações de saída fatais.
INSTALLLOGMODE_ERROR
 Registra as mensagens de erro.
INSTALLLOGMODE_EXTRADEBUG
 Envia informações extras de depuração, como informações de criação de identificador, para o arquivo de log.

Windows 2000 e Windows XP: Não há suporte para esse recurso.
INSTALLLOGMODE_WARNING
 Registra as mensagens de aviso.
INSTALLLOGMODE_USER
 Registra as solicitações do usuário.
INSTALLLOGMODE_INFO
 Registra as mensagens de status que não são exibidas.
INSTALLLOGMODE_RESOLVESOURCE
 Solicitação para determinar um local de origem válido.
INSTALLLOGMODE_OUTOFDISKSPACE
 Indica espaço em disco insuficiente.
INSTALLLOGMODE_ACTIONSTART
 Registra o início de novas ações de instalação.
INSTALLLOGMODE_ACTIONDATA
 Registra o registro de dados com a ação de instalação.
INSTALLLOGMODE_COMMONDATA
 Registra os parâmetros para inicialização da interface do usuário.
INSTALLLOGMODE_PROPERTYDUMP
 Registra os valores da propriedade no encerramento.
INSTALLLOGMODE_VERBOSE
 Registra as informações em todos os outros modos de log, exceto para INSTALLLOGMODE_EXTRADEBUG. Isso envia grandes quantidades de informações para um arquivo de log geralmente não úteis para os usuários. Pode ser usado para suporte técnico.
INSTALLLOGMODE_LOGONLYONERROR
 As informações de log são coletadas, mas são salvas com menos frequência no arquivo de log. Isso pode melhorar o desempenho de algumas instalações, mas pode ter pouco benefício para instalações grandes. O arquivo de log é removido quando a instalação é bem-sucedida. Se a instalação falhar, todas as informações de log serão salvas no arquivo de log.

Windows Installer 2.0: Esse modo de log não está disponível.

[in] szLogFile

Especifica a cadeia de caracteres que contém o caminho completo para o arquivo de log. Inserir um nulo desabilita o registro em log; nesse caso, dwlogmode é ignorado. Se um caminho for fornecido, dwlogmode não deverá ser zero.

[in] dwLogAttributes

Especifica com que frequência o buffer de log deve ser liberado.

Valor Significado
INSTALLLOGATTRIBUTES_APPEND
 Se esse valor for definido, o instalador acrescentará o log existente especificado por szLogFile. Se não for definido, qualquer log existente especificado por szLogFile será substituído.
INSTALLLOGATTRIBUTES_FLUSHEACHLINE
 Força o buffer de log a ser liberado após cada linha. Se esse valor não estiver definido, o instalador liberará o buffer de log após 20 linhas chamando FlushFileBuffers.

Valor retornado

Valor Significado
ERROR_INVALID_PARAMETER
 Um modo de log inválido foi especificado.
ERROR_SUCCESS
 A função foi bem-sucedida.

Comentários

Para obter uma descrição da política de registro em log, consulte Política do Sistema.

O caminho para o local do arquivo de log já deve existir ao usar essa função. O Instalador não cria a estrutura de diretório para o arquivo de log.

Observação

O cabeçalho msi.h define MsiEnableLog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte 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. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino Windows
Cabeçalho msi.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de interface e registro em log

Logging