Formato di un corpo della sezione Log di testo

Un corpo della sezione log di testo contiene zero o più voci di log che si applicano all'operazione associata a una sezione log di testo. Il formato di una voce del log del corpo della sezione include un campo entry_prefix, un campo time_stamp, un campoevent_category, un campo di rientroe un campo formatted_message, come indicato di seguito:

entry_prefix time_stamp event_category rientro formatted_message
La lunghezza massima, in caratteri, di una voce del registro corpo sezione è 336.

campo entry_prefix
Indica se la voce di log è un messaggio di errore, un messaggio di avviso o un messaggio informativo. Il campo entry_prefix è sempre presente e contiene una delle stringhe elencate nella tabella seguente:

campo Entry_prefix	Tipo del messaggio
"!!!    "	Messaggio di errore
"!      "	Messaggio di avviso
" "	Messaggio informativo diverso da un messaggio di errore o un messaggio di avviso

campo time_stamp
Indica l'ora di sistema in cui si è verificato l'evento registrato. Il campo time_stamp è facoltativo e SetupAPI non include un timestamp per impostazione predefinita. Tuttavia, SetupWriteTextLog supporta l'inclusione di un timestamp in una voce di log. Il formato del campo time_stamp è lo stesso del formato del campo time_stamp descritto in Formato di intestazione sezione log di testo.

campo event_category
Indica la categoria dell'operazione SetupAPI che ha effettuato la voce del log. Il campo event_category è in genere presente, ma non è obbligatorio. Se il campo event_category è presente, conterrà una delle stringhe elencate nella tabella seguente:

stringhe di campo Event_category	Operazione SetupAPI
"...: "	Operazione fornita dal fornitore
"bak: "	Dati di backup
"cci: "	Installazione di classi o operazione di co-installazione
"cpy: "	Copiare i file
"dvi: "	Installazione dispositivi
"flq: "	Gestire le code di file
"inf: "	Gestire i file INF
"ndv: "	Creazione guidata nuovo dispositivo
"prp: "	Gestire le proprietà del dispositivo e del driver
"reg: "	Gestire le impostazioni del registro
"set: "	Configurazione generale
"sig: "	Verificare le firme digitali
"sto: "	Gestire l'archivio driver
"ui : "	Gestire le finestre di dialogo dell'interfaccia utente
"ump: "	Gestione PnP in modalità utente

campo di rientro
È costituita da una sequenza di unità di rientro zero o più, in cui un'unità di rientro è una stringa monospace che contiene cinque spazi. Il campo di rientro è facoltativo e SetupAPI non include il rientro per impostazione predefinita. SetupWriteTextLog supporta la modifica del numero di unità di rientro incluse in una voce di log.

campo formatted_message
Contiene le informazioni specifiche applicabili alla voce di log.

Le voci del corpo della sezione registrate dipendono dal livello di evento impostato per il log e i livelli di categoria abilitati per il log. Per altre informazioni su queste impostazioni, vedere Impostazioni del Registro di sistema di registrazione setupAPI.

Quando SetupAPI crea una sezione che raggruppa le operazioni che si applicano a un'installazione del dispositivo, raggruppa anche le voci del log del corpo in modo ricorsivo nelle sottosezioni. SetupAPI distingue le sottosezioni in base al modo in cui annota e rientro le voci del log. Una di queste sottosezioni viene visualizzata nell'estratto seguente da una sezione tipica dell'installazione del dispositivo. La sottosezione inizia con la voce di log "dvi: {Build Driver List}" e termina con la voce di log "dvi: {Build Driver List - exit(0x00000000)}". Questa sottosezione mostra una sequenza tipica di voci di log che includono i campi entry_prefix, event_category, rientro e formatted_message. Le operazioni setupAPI che hanno scritto le voci di log hanno anche creato il rientro e fornito il contenuto dei messaggi formattati. Il livello di evento per questo esempio è stato impostato su TXTLOG_DETAILS e tutti i livelli di categoria sono stati abilitati per questo esempio.

>>>  [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)]