Compartilhar via

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 ser um ou mais dos valores a seguir.

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

Windows 2000 e Windows XP: Não há suporte para esse recurso.
INSTALLLOGMODE_WARNING
 Registra as mensagens de aviso em log.
INSTALLLOGMODE_USER
 Registra em log as solicitações do usuário.
INSTALLLOGMODE_INFO
 Registra em log 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 útil para os usuários. Pode ser usado para suporte técnico.
INSTALLLOGMODE_LOGONLYONERROR
 As informações de registro em 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: Este 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 log nulo desabilita, 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 de retorno

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

Observações

Para obter uma descrição da política de registro em log, consulte System Policy.

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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino Windows
cabeçalho msi.h
biblioteca Msi.lib
de DLL Msi.dll

Consulte também

interface e funções de log

de registro em log do