Aufrufen von SetupWriteTextLog

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

Wie unter Format eines Textprotokollabschnittstexts beschrieben, besteht das Format eines Protokolleintrags aus den folgenden Feldern:

entry_prefix time_stamp event_category indentation formatted_message

Um SetupWriteTextLog aufzurufen, stellt eine Anwendung die folgenden Informationen bereit:

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

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

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

• Ein Flagwert, der ein bitweises OR von systemdefinierten Konstanten ist, die die Ereignisebene, die Einzugstiefe und die Angabe, ob ein Zeitstempel eingeschlossen werden soll. 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, um die Informationen in einem Abschnitt einfacher zu lesen und zu verstehen. Weitere Informationen finden Sie unter Schreiben von Protokolleinträgen mit Einzug.

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

• Eine durch Trennzeichen getrennte Liste von Variablen, deren Werte von der printf-kompatiblen Formatzeichenfolge formatiert werden.

Ein Beispiel zum Aufrufen von SetupWriteTextLog zum Protokollieren von Informationen zu einem Ereignis, das kein Fehler oder eine Warnung ist, 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.