Compartilhar via

Logs de Texto setupAPI

  • Artigo

No Windows Vista e versões posteriores do Windows, o SetupAPI dá suporte a um log de texto de instalação do dispositivo (SetupAPI.dev.log) e um log de texto de instalação do aplicativo (SetupAPI.app.log). O gerenciador de Plug and Play (PnP) e as entradas de gravação de SetupAPI no log de texto de instalação do dispositivo para fornecer informações sobre operações que instalam dispositivos e drivers. O gerenciador PnP e as entradas de gravação de SetupAPI no log de texto de instalação do aplicativo que fornecem informações sobre operações de instalação diferentes daquelas que pertencem especificamente a instalações de dispositivo e driver.

Aplicativos de instalação, instaladores de classe e co-instaladores podem usar as funções de log SetupAPI para gravar entradas no log de instalação do dispositivo e no log de texto de instalação do aplicativo.

Os logs de texto SetupAPI são arquivos de texto sem formatação ANSI, que estão localizados por padrão no diretório %SystemRoot%\inf . Os logs de texto estão no idioma inglês (Standard).

Os logs de texto SetupAPI têm o seguinte formato interno:

  • Uma entrada de log é uma linha em um log de texto.

  • As primeiras entradas de log fornecem um cabeçalho de log de texto que contém informações sobre o sistema operacional e a arquitetura do computador. Para obter mais informações, consulte Formato de um cabeçalho de log de texto.

  • Seguindo o cabeçalho do log de texto estão zero ou mais seções de log de texto. Cada seção de log de texto registra os eventos durante uma única instalação do dispositivo.

    A finalidade de uma seção de log de texto é agrupar e formatar uma sequência contígua de entradas de log que fornecem informações sobre uma operação de instalação específica. Ao criar seções de log de texto, o gerenciador PnP, a SetupAPI ou um aplicativo de instalação personalizado podem organizar entradas de log de maneira conceitualmente significativa. Por exemplo, o gerenciador PnP pode criar uma seção de log de texto para agrupar todas as entradas de log que se aplicam à instalação de um dispositivo. As seções de log de texto aparecem em um log de texto na ordem em que são criadas. Para obter mais informações, consulte Formatar uma seção de log de texto.

  • Um log de texto pode conter entradas de log que não fazem parte do cabeçalho do log de texto ou de uma seção de log de texto. Essas entradas são associadas a operações que não fazem parte de nenhuma seção de log de texto específica e, em geral, são intercaladas entre seções de log de texto. As entradas de log que não fazem parte de uma seção de log de texto aparecem no log na mesma ordem em que são gravadas no log de texto. Para obter mais informações sobre essas entradas de log, consulte Formatar entradas de log que não fazem parte de uma seção de log de texto.