Impostazione del livello di evento per un log di testo

SetupAPI scrive una voce di log in un log di testo solo se il livello di evento impostato per un log di testo è maggiore o uguale al livello di evento per la voce di log e la categoria di eventi per la voce di log è abilitata per il log di testo.

Nella tabella seguente sono elencati i livelli di evento supportati da SetupAPI e le costanti del manifesto che rappresentano questi livelli di evento. TXTLOG_ERROR è il livello di evento più basso, seguito dal livello di evento più alto successivo TXTLOG_WARNING e così via. TXTLOG_VERY_VERBOSE è il livello di evento più alto.

Livello di evento	Costante del manifesto a livello di evento	Valore manifesto a livello di evento
Scrivere solo errori.	TXTLOG_ERROR	1
Scrivere errori e avvisi di potenziali problemi.	TXTLOG_WARNING	2
Scrivere errori, avvisi e modifiche dello stato del sistema.	TXTLOG_SYSTEM_STATE_CHANGE	3
Scrivere errori, avvisi, modifiche dello stato del sistema e operazioni di alto livello associate alle modifiche dello stato.	TXTLOG_SUMMARY	4
Scrivere errori, avvisi, modifiche dello stato del sistema, operazioni di alto livello associate alle modifiche dello stato e la maggior parte dei dettagli operativi.	TXTLOG_DETAILS	5
Scrivere errori, avvisi, modifiche dello stato del sistema, operazioni di alto livello associate alle modifiche dello stato e tutti i dettagli operativi.	TXTLOG_VERBOSE	6
Scrivere tutte le voci di log, incluse quelle che potrebbero generare una grande quantità di informazioni spesso superflue.	TXTLOG_VERY_VERBOSE	7

Per impostare il livello di evento per i log di testo SetupAPI, creare (o modificare) il valore del Registro di sistema seguente REG_DWORD :
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogLevel

Se il valore del Registro di sistema LogLevel non esiste o ha un valore pari a zero, SetupAPI imposta il livello di evento per l'installazione dell'applicazione e i log di testo dell'installazione del dispositivo sui valori predefiniti descritti nella tabella seguente:

Log di testo	Valore predefinito (Windows 7 e versioni successive)	Valore predefinito (Windows Vista SP2)	Valore predefinito (Windows Vista SP1 e versioni precedenti)
Log di testo dell'installazione dell'applicazione (SetupAPI.app.log)	TXTLOG_SUMMARY	TXTLOG_WARNING	TXTLOG_DETAILS
Log del testo dell'installazione del dispositivo (SetupAPI.dev.log)	TXTLOG_DETAILS	TXTLOG_DETAILS	TXTLOG_DETAILS

Per altre informazioni su questi file di log di testo, vedere Log di testo setupAPI.

Il valore del Registro di sistema LogLevel viene formattato come 0xUUUUGHVW, dove:

• Gli otto bit di basso ordine, rappresentati dalla maschera 0x000000VW, specificano se la registrazione è attivata per il log di installazione dell'applicazione e specificare il livello di evento per il registro applicazioni.

• Gli otto bit più alti successivi, rappresentati dalla maschera 0x0000GH00, specificano se la registrazione è attivata per il log di testo dell'installazione del dispositivo e specificare il livello di evento per il log di testo dell'installazione del dispositivo.

• I bit di livello più alto, rappresentati dalla mascheraUUUU0000, non vengono usati.

Il valore dei bit 0xVW controlla la registrazione per il log di installazione dell'applicazione, come illustrato nella tabella seguente.

Valore 0xVW	Descrizione
Zero (impostazione predefinita)	La registrazione è attivata e il livello di evento è impostato sul valore predefinito come descritto in precedenza.
0x01 tramite 0x0F	Disattiva la registrazione.
0x10 tramite 0x7F	Attiva la registrazione e imposta il livello di evento su 0xV.

Il valore dei bitGH 0x controlla la registrazione per il log di testo dell'installazione del dispositivo, come illustrato nella tabella seguente.

Valore 0xGH	Descrizione
Zero (impostazione predefinita)	La registrazione è attivata e il livello di evento è impostato sul valore predefinito come descritto in precedenza.
0x01 tramite 0x0F	Disattiva la registrazione.
0x10 tramite 0x7F	Attiva la registrazione e imposta il livello di evento su 0xG.

Nella tabella seguente vengono forniti esempi di valori LogLevel tipici.

Valore LogLevel	Livelli di evento impostati per i log di testo
0x00000000	Per impostazione predefinita, attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione sui valori predefiniti per entrambi i log.
0x00000101	Disattiva la registrazione sia per il log di installazione dell'applicazione che per il log di installazione del dispositivo.
0x00001010	Attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione su TXTLOG_ERROR per entrambi i log.
0x00002020	Attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione su TXTLOG_WARNING per entrambi i log.
0x00005050	Attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione su TXTLOG_DETAILS per entrambi i log.
0x00006060	Attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione su TXTLOG_VERBOSE per entrambi i log.
0x00007070	Attiva la registrazione per il log di installazione dell'applicazione e il log di installazione del dispositivo. Imposta il livello di registrazione su TXTLOG_VERY_VERBOSE per entrambi i log.