Aufruf von SetupWriteTextLog

SetupWriteTextLog fügt einem SetupAPI-Textprotokoll einen einzelnen Eintrag mit Informationen zu einem Installationsereignis hinzu.

Wie im Format des Hauptteils eines Textprotokollabschnitts beschrieben, besteht das Format eines Protokolleintrags aus den folgenden Feldern:

entry_prefix time_stamp event_category indentation formatted_message

Zum Aufrufen von SetupWriteTextLog stellt eine Anwendung folgende Informationen bereit:

• Das Protokolltoken für einen Abschnitt in einem Textprotokoll, das durch Aufrufen von SetupGetThreadLogToken abgerufen wurde, oder eines der vom System definierten Protokolltoken. Wenn das Protokolltoken einem Textprotokollabschnitt zugeordnet ist, schreibt SetupWriteTextLog den Protokolleintrag in diesen Abschnitt. Andernfalls fügt SetupWriteTextLog den Protokolleintrag zu einem Teil des Protokolls hinzu, der nicht in einem Textprotokollabschnitt enthalten ist. Darüber hinaus hängt die Angabe, ob SetupWriteTextLog einen Protokolleintrag schreibt und in welches Textprotokoll SetupWriteTextLog den Eintrag schreibt, vom vom vom System definierten Protokolltokenwert ab.

  Weitere Informationen zu Protokolltoken finden Sie unter Festlegen und Abrufen eines Protokolltokens für einen Thread.

• Eine der Ereigniskategorien, die in Aktivieren von Ereigniskategorien für ein Textprotokoll beschrieben wird. Wenn die Ereigniskategorie für den Eintrag für das Textprotokoll aktiviert ist, fügt SetupWriteTextLog den Eintrag zum Textprotokoll hinzu. andernfalls schreibt SetupWriteTextLog den Eintrag nicht in das Textprotokoll.

• Ein Flagwert, der ein bitweises ODER systemdefinierter Konstanten ist, die die Ereignisebene, die Einzugstiefe und die Angabe, ob ein Zeitstempel eingeschlossen werden soll, festlegen. Ereignisebenen werden unter Festlegen der Ereignisebene für ein Textprotokoll beschrieben. Wenn die für das Textprotokoll festgelegte Ereignisebene größer oder gleich der Ereignisebene für den Eintrag ist, schreibt SetupWriteTextLog einen Protokolleintrag in das Textprotokoll; andernfalls schreibt SetupWriteTextLog keinen Protokolleintrag in das Textprotokoll. Mithilfe des Einzugs können formatierte Nachrichten angeordnet werden, damit die Informationen in einem Abschnitt leichter zu lesen und zu verstehen sind. Weitere Informationen finden Sie unter Einrückte Protokolleinträge schreiben.

• Eine printf-kompatible Formatzeichenfolge, die sowohl die Nachricht als auch die Liste der durch Kommas getrennten Variablen formatiert, die auf die Formatzeichenfolge folgt.

• Eine durch Kommas getrennte Liste von Variablen, deren Werte durch die printf-kompatible Formatzeichenfolge formatiert sind.

Ein Beispiel zum Aufrufen von SetupWriteTextLog zum Protokollieren von Informationen zu einem Ereignis, bei dem es sich nicht um einen Fehler oder eine Warnung handelt, finden Sie unter Schreiben eines Informationsprotokolleintrags.

Ein Beispiel zum Aufrufen von SetupWriteTextLog zum Protokollieren von Informationen zu einem Fehler oder einer Warnung finden Sie unter Schreiben eines Fehler- oder Warnungsprotokolleintrags.