Log di testo setupAPI

In Windows Vista and later versions of Windows, SetupAPI supports a device installation text log (SetupAPI.dev.log) and an application installation text log (SetupAPI.app.log). La gestione Plug and Play (PnP) e le voci di scrittura SetupAPI nel log di testo dell'installazione del dispositivo per fornire informazioni sulle operazioni che installano dispositivi e driver. Le voci di scrittura PnP Manager e SetupAPI nel log di testo dell'installazione dell'applicazione che forniscono informazioni sulle operazioni di installazione diverse da quelle relative in modo specifico alle installazioni di dispositivi e driver.

Le applicazioni di installazione, i programmi di installazione di classe e i co-installer possono usare le funzioni di registrazione SetupAPI per scrivere voci nel log di installazione del dispositivo e nel log di testo dell'installazione dell'applicazione.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. I log di testo si trovano nella lingua inglese (standard).

I log di testo SetupAPI hanno il formato interno seguente:

• A log entry is one line in a text log.

• Le prime voci di log forniscono un'intestazione del log di testo che contiene informazioni sul sistema operativo e sull'architettura del computer. Per altre informazioni, vedere Formato di un'intestazione del log di testo.

• Dopo l'intestazione del log di testo sono presenti zero o più sezioni del log di testo. Ogni sezione del log di testo registra gli eventi durante un'installazione di un singolo dispositivo.

  Lo scopo di una sezione del log di testo è raggruppare e formattare una sequenza contigua di voci di log che forniscono informazioni su una particolare operazione di installazione. Creando sezioni del log di testo, gestione PnP, SetupAPI o un'applicazione di installazione personalizzata può organizzare le voci di log in modo concettualmente significativo. Ad esempio, il gestore PnP potrebbe creare una sezione del log di testo per raggruppare tutte le voci di log applicabili all'installazione di un dispositivo. Le sezioni del log di testo vengono visualizzate in un log di testo nell'ordine in cui vengono create. Per altre informazioni, vedere Formato di una sezione Log di testo.

• Un log di testo può contenere voci di log che non fanno parte dell'intestazione del log di testo o di una sezione del log di testo. Tali voci sono associate alle operazioni che non fanno parte di alcuna sezione del log di testo particolare e, in generale, vengono interpersate tra le sezioni del log di testo. Le voci di log che non fanno parte di una sezione del log di testo vengono visualizzate nel log nello stesso ordine in cui vengono scritte nel log di testo. Per altre informazioni su tali voci di log, vedere Formato delle voci di log che non fanno parte di una sezione log di testo.