Freigeben über

Schreiben eines Informationsprotokolleintrags

  • Artikel

Das folgende Beispiel zeigt, wie eine Anwendung in der Regel SetupWriteTextLog aufrufen kann, um einen Informationseintrag in ein SetupAPI-Textprotokoll zu schreiben, bei dem es sich weder um eine Warnmeldung noch um eine Fehlermeldung handelt.

Informationen zum Aufrufen von SetupWriteTextLog zum Protokollieren einer Fehlermeldung finden Sie unter Aufrufen von SetupWriteTextLog zum Protokollieren eines Fehlers oder Warnungseintrags.

Die Anwendung ruft SetupWriteTextLog auf und gibt die folgenden Parameterwerte an:

  • LogToken ist auf einen Protokolltokenwert festgelegt, der entweder durch aufrufen von SetupGetThreadLogToken abgerufen wurde oder einer der systemdefinierte Protokolltokenwerte ist, die in den Protokolltoken beschrieben werden.

  • Kategorie ist auf TXTLOG_VENDOR festgelegt, was angibt, dass der Protokolleintrag von einer vom Anbieter bereitgestellten Anwendung erfolgt. Ereigniskategorien werden unter Aktivieren von Ereigniskategorien für ein Textprotokoll beschrieben.

  • Flags ist auf ein bitweises OR mit TXTLOG_DETAILS und TXTLOG_TIMESTAMP festgelegt. In diesem Beispiel wird die Einzugstiefe nicht geändert, und die aktuelle Einzugstiefe wurde zuvor auf fünf Monospace-Texträume festgelegt. Informationen zum Ändern der Einzugstiefe finden Sie unter Schreiben von eingezogenen Protokolleinträgen. Ereignisebenen werden im Thema Festlegen der Ereignisebene für ein Textprotokoll beschrieben.

  • MessageStr ist auf TEXT("Variable of interest: = %d") festgelegt.

  • Die durch Trennzeichen getrennte Parameterliste enthält die Variable SomeVariable, die dem Feld "%d" in MessageStr entspricht.

//The LogToken value was previously returned by call to
//SetupGetThreadLogToken or one of the system-defined log token values
DWORD Category = TXTLOG_VENDOR; 
DWORD Flags = TXTLOG_DETAILS | TXTLOG_TIMESTAMP;
DWORD SomeVariable = 1;   // The variable whose value will be logged

SetupWriteTextLog(LogToken, Category, Flags, TEXT("Variable of interest: = %d"), SomeVariable);

Wenn die TXTLOG_VENDOR Ereigniskategorie aktiviert ist und die TXTLOG_DETAILS Ereignisebene für das Textprotokoll für die Geräteinstallation festgelegt ist, erstellt dieser Code einen Eintrag im Geräteinstallationsprotokoll im folgenden Format, in dem der Zeitstempel durch einen tatsächlichen Zeitstempel ersetzt wird.

     2005/02/13 22:06:28.109:    :  Variable of interest: Abc = 1