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 manifesto che rappresentano questi livelli di evento. TXTLOG_ERROR è il livello di evento più basso, seguito dal successivo livello di evento più alto TXTLOG_WARNING e così via. TXTLOG_VERY_VERBOSE è il livello di evento più alto.

Livello di evento	Costante manifesto a livello di evento	Valore manifesto a livello di evento
Scrivere solo errori.	TXTLOG_ERROR	1
Scrivere errori e avvisi relativi a potenziali problemi.	TXTLOG_WARNING	2
Scrivere errori, avvisi e modifiche dello stato del sistema.	Registro_cambio_stato_di_sistema	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 possono 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 REG_DWORD seguente:
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:

Registro 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 (AVVISO)	TXTLOG_DETAILS
Log di 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.

• I successivi otto bit più alti, 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 maschera 0xUUUU0000, non vengono usati.

Il valore dei bit 0xVW controlla la registrazione dei log per l'installazione dell'applicazione, come mostrato 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 a 0x0F	Disattiva la registrazione.
0x10 a 0x7F	Attiva la registrazione e imposta il livello di evento su 0xV.

Il valore dei bit 0xGH controlla la registrazione nel 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 a 0x0F	Disattiva la registrazione.
0x10 a 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 l'accesso 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.