SetupAPI-Textprotokolle

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). Der Plug and Play-Manager (PnP) und SetupAPI schreiben Einträge in das Textprotokoll der Geräteinstallation, um Informationen zu Vorgängen bereitzustellen, die Geräte und Treiber installieren. Der PnP-Manager und SetupAPI schreiben Einträge in das Textprotokoll der Anwendungsinstallation, das Informationen zu anderen Installationsvorgängen als denen bereitstellt, die speziell für Geräte- und Treiberinstallationen gelten.

Installationsanwendungen, Klasseninstallationsprogramme und Co-Installer können die SetupAPI-Protokollierungsfunktionen verwenden, um Einträge in das Installationsprotokoll des Geräts und das Installationstextprotokoll der Anwendung zu schreiben.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Die Textprotokolle befinden sich in der Sprache Englisch (Standard).

Die SetupAPI-Textprotokolle weisen das folgende interne Format auf:

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

• Die ersten Protokolleinträge stellen einen Textprotokollheader bereit, der Informationen zur Betriebssystem- und Computerarchitektur enthält. Weitere Informationen finden Sie unter Format eines Textprotokollheaders.

• Nach dem Textprotokollheader sind null oder mehr Textprotokollabschnitte vorhanden. Jeder Textprotokollabschnitt zeichnet die Ereignisse während einer einzelnen Geräteinstallation auf.

  Der Zweck eines Textprotokollabschnitts besteht darin, eine zusammenhängende Abfolge von Protokolleinträgen zu gruppieren und zu formatieren, die Informationen zu einem bestimmten Installationsvorgang bereitstellen. Durch das Erstellen von Textprotokollabschnitten kann der PnP-Manager, SetupAPI oder eine benutzerdefinierte Installationsanwendung Protokolleinträge konzeptionell sinnvoll organisieren. Beispielsweise kann der PnP-Manager einen Textprotokollabschnitt erstellen, um alle Protokolleinträge zu gruppieren, die für die Installation eines Geräts gelten. Textprotokollabschnitte werden in einem Textprotokoll in der Reihenfolge angezeigt, in der sie erstellt werden. Weitere Informationen finden Sie unter "Format eines Textprotokollabschnitts".

• Ein Textprotokoll kann Protokolleinträge enthalten, die nicht Teil des Textprotokollheaders oder eines Textprotokollabschnitts sind. Solche Einträge sind Vorgängen zugeordnet, die nicht Teil eines bestimmten Textprotokollabschnitts sind und im Allgemeinen zwischen Textprotokollabschnitten interspersiert werden. Protokolleinträge, die nicht Teil eines Textprotokollabschnitts sind, werden im Protokoll in derselben Reihenfolge angezeigt, in der sie in das Textprotokoll geschrieben werden. Weitere Informationen zu solchen Protokolleinträgen finden Sie im Format von Protokolleinträgen, die nicht Teil eines Textprotokollabschnitts sind.