Format eines Textprotokollabschnitt-Textes

Ein Textprotokollabschnittstext enthält null oder mehr Protokolleinträge, die für den Vorgang gelten, der einem Textprotokollabschnitt zugeordnet ist. The format of a section body log entry includes an entry_prefix field, a time_stamp field, an event_category field, an indentation field, and a formatted_message field, as follows:

entry_prefix time_stamp event_category Einzug formatted_message
Die maximale Länge eines Abschnittstextprotokolleintrags in Zeichen beträgt 336.

entry_prefix field
Gibt an, ob der Protokolleintrag eine Fehlermeldung, eine Warnmeldung oder eine Informationsmeldung ist. The entry_prefix field is always present and contains one of the strings that are listed in the following table:

time_stamp field
Gibt die Systemzeit an, zu der das protokollierte Ereignis aufgetreten ist. The time_stamp field is optional and SetupAPI doesn't include a time stamp by default. However, SetupWriteTextLog supports including a time stamp in a log entry. The format of the time_stamp field is the same as the format of the time_stamp field that is described in Format of a Text Log Section Header.

event_category field
Gibt die Kategorie des SetupAPI-Vorgangs an, der den Protokolleintrag erstellt hat. The event_category field is usually present, but isn't required. If the event_category field is present, it will contain one of the strings that are listed in the following table:

indentation field
Consists of a sequence of zero or more indentation units, where an indentation unit is a monospace string that contains five spaces. The indentation field is optional and SetupAPI doesn't include indentation by default. SetupWriteTextLog supports changing the number of indentation units that are included in a log entry.

formatted_message field
Enthält die spezifischen Informationen, die für den Protokolleintrag gelten.

Die protokollierten Abschnittstexteinträge hängen von der Ereignisebene ab, die für das Protokoll festgelegt ist, und von den Kategorieebenen, die für das Protokoll aktiviert sind. Weitere Informationen zu diesen Einstellungen finden Sie unter SetupAPI-Protokollierungsregistrierungseinstellungen.

Wenn SetupAPI einen Abschnitt erstellt, der Vorgänge gruppiert, die für eine Geräteinstallation gelten, gruppiert, gruppiert es auch rekursive Abschnittstextprotokolleinträge in Unterabschnitten. SetupAPI unterscheidet Unterabschnitte durch die Art und Weise, wie sie Protokolleinträge kommentiert und einrückt. Ein solcher Unterabschnitt wird im folgenden Auszug aus einem typischen Abschnitt zur Geräteinstallation angezeigt. Der Unterabschnitt beginnt mit dem Protokolleintrag "dvi: {Build Driver List}" und endet mit dem Protokolleintrag "dvi: {Build Driver List - exit(0x00000000)}". This subsection shows a typical sequence of log entries that include the entry_prefix, event_category, indentation, and formatted_message fields. Die SetupAPI-Vorgänge, die die Protokolleinträge geschrieben haben, haben auch den Einzug erstellt und den Inhalt der formatierten Nachrichten bereitgestellt. Die Ereignisebene für dieses Beispiel wurde auf TXTLOG_DETAILS festgelegt, und alle Kategorieebenen wurden für dieses Beispiel aktiviert.

>>>  [Device Install - PCI\VEN_104C&DEV_8019&SUBSYS_8010104C&REV_00\3&61aaa01&0&38]
>>>  2005/02/13 22:06:28.109: Section start
...
 Additional section body log entries
...
     dvi: {Build Driver List}
     dvi:      Enumerating all INFs...
     dvi:      Found driver match:
     dvi:           HardwareID - PCI\VEN_104C&DEV_8019
     dvi:           InfName    - C:\WINDOWS\inf\1394.inf
     dvi:           DevDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           DrvDesc    - Texas Instruments OHCI Compliant IEEE 1394 Host Controller
     dvi:           Provider   - Microsoft
     dvi:           Mfg        - Texas Instruments
     dvi:           InstallSec - TIOHCI_Install
     dvi:           ActualSec  - TIOHCI_Install.NT
     dvi:           Rank       - 0x00002001
     dvi:           DrvDate    - 10/01/2002
     dvi:           Version    - 6.0.5033.0 
!!!  inf:      InfCache: Error flagging 1394.inf for match string pci\ven_104c&dev_8019
     dvi: {Build Driver List - exit(0x00000000)}
...
 Additional section body log entries 
...
<<<  [2005/02/13 22:06:29.000: Section end]
<<<  [Exit Status(0x00000000)]