Log di testo SetupAPI

  • Articolo

In Windows Vista e versioni successive di Windows, SetupAPI supporta un log del testo di installazione del dispositivo (SetupAPI.dev.log) e un log di testo dell'installazione dell'applicazione (SetupAPI.app.log). 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 coinstallazioni 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.

I log di testo SetupAPI sono file di testo normale ANSI, che si trovano per impostazione predefinita nella directory %SystemRoot%\inf . I log di testo si trovano nella lingua inglese (standard).

I log di testo SetupAPI hanno il formato interno seguente:

  • Una voce di log è una riga in un log di testo.

  • 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 determinata 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 che si applicano 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 a operazioni che non fanno parte di alcuna sezione del log di testo specifica e, in generale, sono interperse 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.