Formato de un cuerpo de sección de registro de texto

Un cuerpo de sección de registro de texto contiene cero o más entradas de registro que se aplican a la operación asociada a una sección de registro de texto. El formato de una entrada de registro del cuerpo de sección incluye un campo de entry_prefix , un campo de time_stamp , un campo de event_category , un campo de sangría y un campo de formatted_message , como se indica a continuación:

entry_prefix time_stamp event_category formatted_message de sangría
La longitud máxima, en caracteres, de una entrada de registro del cuerpo de sección es 336.

campo entry_prefix
Indica si la entrada del registro es un mensaje de error, un mensaje de advertencia o un mensaje de información. El campo entry_prefix siempre está presente y contiene una de las cadenas que se enumeran en la tabla siguiente:

campo time_stamp
Indica la hora del sistema en que se produjo el evento registrado. El campo time_stamp es opcional y SetupAPI no incluye una marca de tiempo de forma predeterminada. Sin embargo, SetupWriteTextLog admite la inclusión de una marca de tiempo en una entrada de registro. El formato del campo time_stamp es el mismo que el del campo de time_stamp que se describe en Formato de un encabezado de sección de registro de texto.

campo event_category
Indica la categoría de operación SetupAPI que realizó la entrada de registro. El campo event_category suele estar presente, pero no es necesario. Si el campo event_category está presente, contendrá una de las cadenas que se enumeran en la tabla siguiente:

campo de sangría
Consta de una secuencia de cero o más unidades de sangría, donde una unidad de sangría es una cadena monoespacial que contiene cinco espacios. El campo de sangría es opcional y SetupAPI no incluye sangría de forma predeterminada. SetupWriteTextLog admite el cambio del número de unidades de sangría que se incluyen en una entrada de registro.

campo formatted_message
Contiene la información específica que se aplica a la entrada de registro.

Las entradas del cuerpo de la sección que se registran dependen del nivel de evento establecido para el registro y los niveles de categoría habilitados para el registro. Para obtener más información sobre esta configuración, consulte Configuración del Registro de LA API.

Cuando SetupAPI crea una sección que agrupa las operaciones que se aplican a una instalación de dispositivo, también agrupa de forma recursiva las entradas del registro del cuerpo de sección en las subsecciones. SetupAPI distingue las subsecciones por la forma en que anota y aplica sangría a las entradas del registro. Una de estas subsecciones aparece en el siguiente extracto de una sección típica de instalación de dispositivos. La subsección comienza con la entrada de registro "dvi: {Build Driver List}" y termina con la entrada de registro "dvi: {Build Driver List - exit(0x00000000)}". Esta subsección muestra una secuencia típica de entradas de registro que incluyen los campos entry_prefix, event_category, sangría y formatted_message . Las operaciones setupAPI que escribieron las entradas de registro también crearon la sangría y proporcionaron el contenido de los mensajes con formato. El nivel de evento de este ejemplo se estableció en TXTLOG_DETAILS y todos los niveles de categoría se habilitaron para este ejemplo.

>>>  [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)]