SetupAPI-tekstlogboeken

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). De Plug and Play-manager (PnP) en SetupAPI-schrijfvermeldingen in het tekstlogboek voor de installatie van het apparaat voor informatie over bewerkingen waarmee apparaten en stuurprogramma's worden geïnstalleerd. De PnP-beheer- en SetupAPI-schrijfvermeldingen in het tekstlogboek voor de installatie van de toepassing die informatie bevatten over andere installatiebewerkingen dan de bewerkingen die specifiek betrekking hebben op apparaat- en stuurprogramma-installaties.

Installatietoepassingen, klasse-installatieprogramma's en co-installatieprogramma's kunnen de setupAPI-logboekregistratiefuncties gebruiken om vermeldingen te schrijven naar het installatielogboek van het apparaat en het installatielogboek van de toepassing.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. De tekstlogboeken zijn in de Engelse taal (Standaard).

De SetupAPI-tekstlogboeken hebben de volgende interne indeling:

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

• De eerste paar logboekvermeldingen bieden een tekstlogboekkop met informatie over het besturingssysteem en de computerarchitectuur. Zie Opmaak van een koptekst van een tekstlogboek voor meer informatie.

• Het volgen van de koptekst van het tekstlogboek is nul of meer secties voor tekstlogboeken. Elke sectie in het tekstlogboek registreert de gebeurtenissen tijdens de installatie van één apparaat.

  Het doel van een tekstlogboeksectie is het groeperen en opmaken van een aaneengesloten reeks logboekvermeldingen die informatie geven over een bepaalde installatiebewerking. Door tekstlogboeksecties te maken, kunnen de PnP-manager, SetupAPI of een aangepaste installatietoepassing logboekvermeldingen op een conceptueel zinvolle manier organiseren. De PnP-manager kan bijvoorbeeld een tekstlogboeksectie maken om alle logboekvermeldingen te groeperen die van toepassing zijn op het installeren van een apparaat. Tekstlogboeksecties worden weergegeven in een tekstlogboek in de volgorde waarin ze worden gemaakt. Zie De indeling van een tekstlogboeksectie voor meer informatie.

• Een tekstlogboek kan logboekvermeldingen bevatten die geen deel uitmaken van de koptekst van het tekstlogboek of een tekstlogboeksectie. Dergelijke vermeldingen zijn gekoppeld aan bewerkingen die geen deel uitmaken van een bepaalde sectie van het tekstlogboek en, in het algemeen, tussen tekstlogboeksecties worden verdeeld. Logboekvermeldingen die geen deel uitmaken van een tekstlogboeksectie worden weergegeven in het logboek in dezelfde volgorde waarin ze naar het tekstlogboek worden geschreven. Zie Indeling van logboekvermeldingen die geen deel uitmaken van een tekstlogboeksectie voor meer informatie over dergelijke logboekvermeldingen.