Compartir a través de

Escribir una entrada de registro de información

  • Artículo

En el ejemplo siguiente se muestra cómo una aplicación normalmente podría llamar a SetupWriteTextLog para escribir una entrada de información en un registro de texto setupAPI que no es un mensaje de advertencia o un mensaje de error.

Para obtener información sobre cómo llamar a SetupWriteTextLog para registrar un mensaje de error, vea Llamar a SetupWriteTextLog para registrar un error o una entrada de advertencia.

La aplicación llama a SetupWriteTextLog, proporcionando los siguientes valores de parámetro:

  • LogToken se establece en un valor de token de registro que se obtuvo mediante una llamada a SetupGetThreadLogToken o es uno de los valores de token de registro definidos por el sistema que se describen en los tokens de registro.

  • La categoría se establece en TXTLOG_VENDOR, lo que indica que una aplicación proporcionada por el proveedor realiza la entrada de registro. Las categorías de eventos se describen en Habilitación de categorías de eventos para un registro de texto.

  • Las marcas se establecen en un OR bit a bit de TXTLOG_DETAILS y TXTLOG_TIMESTAMP. En este ejemplo, la profundidad de sangría no cambia y la profundidad de sangría actual se estableció anteriormente en cinco espacios de texto monoespacio. Para obtener información sobre cómo cambiar la profundidad de sangría, vea Escribir entradas de registro con sangría. Los niveles de eventos se describen en el tema Establecimiento del nivel de evento para un registro de texto .

  • MessageStr se establece en TEXT("Variable de interés: = %d").

  • La lista de parámetros separados por comas proporciona la variable SomeVariable, que corresponde al campo "%d" de MessageStr.

//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);

Si la categoría de eventos de TXTLOG_VENDOR está habilitada y el nivel de evento TXTLOG_DETAILS se establece para el registro de texto de instalación del dispositivo, este código crearía una entrada en el registro de instalación del dispositivo en el siguiente formato, donde la marca de tiempo se reemplazaría por una marca de tiempo real.

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