textloggar för SetupAPI

I Windows Vista och senare versioner av Windows stöder SetupAPI en textlogg för enhetsinstallation (SetupAPI.dev.log) och en textlogg för programinstallation (SetupAPI.app.log). Skrivposterna technológia Plug and Play (PnP) och SetupAPI till enhetsinstallationens textlogg för att ge information om åtgärder som installerar enheter och drivrutiner. PnP-hanteraren och SetupAPI-skrivposterna till programinstallationens textlogg som innehåller information om andra installationsåtgärder än de som specifikt gäller enhets- och drivrutinsinstallationer.

Installationsprogram, klassinstallationsprogram och saminstallationsprogram kan använda installationsfunktionerna för loggning av InstallationAPI för att skriva poster till enhetsinstallationsloggen och textloggen för programinstallationen.

InstallationsAPI-textloggarna är ANSI-oformaterade textfiler, som finns som standard i katalogen%SystemRoot%\inf . Textloggarna är på engelska (Standard).

InstallationsAPI-textloggarna har följande interna format:

  • En loggpost är en rad i en textlogg.

  • De första loggposterna innehåller ett textlogghuvud som innehåller information om operativsystemet och datorarkitekturen. Mer information finns i Formatera ett textlogghuvud.

  • Följande textloggrubrik är noll eller fler textloggavsnitt. Varje textloggavsnitt registrerar händelserna under en enda enhetsinstallation.

    Syftet med ett textloggavsnitt är att gruppera och formatera en sammanhängande sekvens med loggposter som ger information om en viss installationsåtgärd. Genom att skapa textloggavsnitt kan PnP-chefen, SetupAPI eller ett anpassat installationsprogram organisera loggposter på ett konceptuellt meningsfullt sätt. PnP-hanteraren kan till exempel skapa ett textloggavsnitt för att gruppera alla loggposter som gäller för att installera en enhet. Textloggavsnitt visas i en textlogg i den ordning de skapas. Mer information finns i Avsnittet Format för en textlogg.

  • En textlogg kan innehålla loggposter som inte ingår i textloggrubriken eller ett textloggavsnitt. Sådana poster är associerade med åtgärder som inte ingår i något särskilt textloggavsnitt och som i allmänhet är varvat mellan textloggavsnitt. Loggposter som inte ingår i ett textloggavsnitt visas i loggen i samma ordning som de skrivs till textloggen. Mer information om sådana loggposter finns i Format för loggposter som inte ingår i ett textloggavsnitt.