Freigeben über

SetupAPI-Textprotokolle

  • Artikel

In Windows Vista und höheren Versionen von Windows unterstützt SetupAPI ein Textprotokoll für die Geräteinstallation (SetupAPI.dev.log) und ein Anwendungsinstallationstextprotokoll (SetupAPI.app.log). Der PnP-Manager (Plug & Play) und setupAPI schreiben Einträge in das Textprotokoll der Geräteinstallation, um Informationen zu Vorgängen zur Installation von Geräten und Treibern bereitzustellen. Der PnP-Manager und die SetupAPI schreiben Einträge in das Textprotokoll der Anwendungsinstallation, die Informationen zu anderen Installationsvorgängen als denen enthalten, die sich speziell auf Geräte- und Treiberinstallationen beziehen.

Installationsanwendungen, Klasseninstaller und Co-Installer können die SetupAPI-Protokollierungsfunktionen verwenden, um Einträge in das Geräteinstallationsprotokoll und das Anwendungsinstallationstextprotokoll zu schreiben.

Die SetupAPI-Textprotokolle sind ANSI-Nur-Text-Dateien, die sich standardmäßig im Verzeichnis %SystemRoot%\inf befinden. Die Textprotokolle sind in der Sprache Englisch (Standard) verfügbar.

Die SetupAPI-Textprotokolle haben das folgende interne Format:

  • Ein Protokolleintrag ist eine Zeile in einem Textprotokoll.

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

  • Auf den Textprotokollheader folgen null oder mehr Textprotokollabschnitte. Jeder Textprotokollabschnitt zeichnet die Ereignisse während einer einzelnen Geräteinstallation auf.

    Der Zweck eines Textprotokollabschnitts besteht darin, eine zusammenhängende Sequenz von Protokolleinträgen zu gruppieren und zu formatieren, die Informationen zu einem bestimmten Installationsvorgang bereitstellen. Durch das Erstellen von Textprotokollabschnitten können 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 Formatieren 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 eingestreut sind. 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 unter Format von Protokolleinträgen, die nicht Teil eines Textprotokollabschnitts sind.