Formato de um corpo de seção de log de texto

Um corpo da seção de log de texto contém zero ou mais entradas de log que se aplicam à operação associada a uma seção de log de texto. O formato de uma entrada de log do corpo da seção inclui um campo de entry_prefix , um campo time_stamp , um campo event_category , um campo de recuo e um campo de formatted_message , da seguinte maneira:

formatted_message de recuo entry_prefix time_stamp event_category
O comprimento máximo, em caracteres, de uma entrada de log do corpo da seção é 336.

campo entry_prefix
Indica se a entrada de log é uma mensagem de erro, uma mensagem de aviso ou uma mensagem de informação. O campo entry_prefix está sempre presente e contém uma das cadeias de caracteres listadas na tabela a seguir:

campo Entry_prefix	Tipo de mensagem
"!!!    "	Uma mensagem de erro
"!      "	Uma mensagem de aviso
" "	Mensagem de informação diferente de uma mensagem de erro ou uma mensagem de aviso

campo time_stamp
Indica a hora do sistema em que o evento registrado ocorreu. O campo time_stamp é opcional e SetupAPI não inclui um carimbo de data/hora por padrão. No entanto, SetupWriteTextLog dá suporte à inclusão de um carimbo de data/hora em uma entrada de log. O formato do campo time_stamp é o mesmo que o formato do campo time_stamp descrito em Formato de um Cabeçalho de Seção de Log de Texto.

campo event_category
Indica a categoria da operação SetupAPI que fez a entrada de log. O campo event_category geralmente está presente, mas não é necessário. Se o campo event_category estiver presente, ele conterá uma das cadeias de caracteres listadas na tabela a seguir:

Event_category cadeias de caracteres de campo	Operação SetupAPI
"...: "	Operação fornecida pelo fornecedor
"bak: "	Dados de backup
"cci: "	Instalador de classe ou operação de co-instalador
"cpy: "	Copiar arquivos
"dvi: "	Instalação do dispositivo
"flq: "	Gerenciar filas de arquivos
"inf: "	Gerenciar arquivos INF
"ndv: "	Assistente para novo dispositivo
"prp: "	Gerenciar propriedades de dispositivo e driver
"reg: "	Gerenciar configurações do registro
"set: "	Configuração geral
"sig: "	Verificar assinaturas digitais
"sto: "	Gerenciar o repositório de driver
"ui : "	Gerenciar caixas de diálogo da interface do usuário
"ump: "	Gerenciador de PnP no modo de usuário

Campo de recuo
Consiste em uma sequência de zero ou mais unidades de recuo, em que uma unidade de recuo é uma cadeia de caracteres monospace que contém cinco espaços. O campo de recuo é opcional e SetupAPI não inclui recuo por padrão. SetupWriteTextLog dá suporte à alteração do número de unidades de recuo incluídas em uma entrada de log.

campo formatted_message
Contém as informações específicas que se aplicam à entrada de log.

As entradas do corpo da seção registradas dependem do nível de evento definido para o log e os níveis de categoria habilitados para o log. Para obter mais informações sobre essas configurações, consulte Configurações do Registro de Log de API.

Quando SetupAPI cria uma seção que agrupa operações que se aplicam a uma instalação de dispositivo, ela também agrupa recursivamente as entradas de log do corpo da seção em subseções. SetupAPI distingue as subseções pela maneira como anota e registra entradas de log. Uma dessas subseções aparece no trecho a seguir de uma seção de instalação típica do dispositivo. A subseção começa com a entrada de log "dvi: {Build Driver List}" e termina com a entrada de log "dvi: {Build Driver List - exit(0x00000000)}". Essa subseção mostra uma sequência típica de entradas de log que incluem os campos entry_prefix, event_category, recuo e formatted_message . As operações SetupAPI que escreveram as entradas de log também criaram o recuo e forneceram o conteúdo das mensagens formatadas. O nível de evento para este exemplo foi definido como TXTLOG_DETAILS e todos os níveis de categoria foram habilitados para este exemplo.

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]