Freigeben über

Schreiben von Protokolleinträgen in ein Textprotokoll

  • Artikel

Eine Anwendung führt eine der folgenden Aktionen aus, um einen Protokolleintrag in ein SetupAPI-Textprotokoll zu schreiben:

  • Ruft SetupWriteTextLog auf, um einen einzelnen Textprotokolleintrag zu schreiben, der Informationen zu einem Installationsereignis enthält.

  • Ruft SetupWriteTextLogError auf, um Informationen zu einem SetupAPI-spezifischen Fehler oder einem Win32-Fehler in ein Textprotokoll zu schreiben. SetupWriteTextLogError schreibt zwei aufeinanderfolgende Einträge in ein Textprotokoll: Der erste Eintrag enthält dieselben Informationen im gleichen Format wie das von SetupWriteTextLog geschriebene, und der zweite Eintrag protokolliert einen entsprechenden Fehlercode und eine benutzerfreundliche Beschreibung des Fehlers.

  • Ruft SetupWriteTextLogInfLine auf, um einen einzelnen Textprotokolleintrag zu schreiben, der den Text einer angegebenen INF-Dateizeile enthält.

Wie unter Format eines Textprotokollabschnittstexts beschrieben, schreiben die SetupAPI-Protokollierungsfunktionen Einträge im folgenden Format:

entry_prefix time_stamp event_category indentation formatted_message

Der Standard Unterschied zwischen den Einträgen, die die verschiedenen SetupAPI-Protokollierungsfunktionen in ein Textprotokoll schreiben, im spezifischen Informationsinhalt und im Format des Felds "formatierte Nachricht".

Informationen zum Festlegen des Einzugsfelds für den Einzug des Felds für die formatierte Nachricht finden Sie unter Schreiben von Protokolleinträgen mit Einzug.