Compartir a través de

Llamar a SetupWriteTextLog

  • Artículo

SetupWriteTextLog agrega una única entrada con información sobre un evento de instalación a un registro de texto setupAPI.

Como se describe en Formato de un cuerpo de sección de registro de texto, el formato de una entrada de registro consta de los campos siguientes:

entry_prefix time_stamp event_category indentation formatted_message

Para llamar a SetupWriteTextLog, una aplicación proporciona la siguiente información:

  • Token de registro de una sección de un registro de texto que se obtuvo mediante una llamada a SetupGetThreadLogToken o a uno de los tokens de registro definidos por el sistema. Si el token de registro está asociado a una sección de registro de texto, SetupWriteTextLog escribe la entrada de registro en esa sección. De lo contrario, SetupWriteTextLog agrega la entrada de registro a una parte del registro que no se incluye en una sección de registro de texto. Además, si SetupWriteTextLog escribe una entrada de registro y en qué registro de texto SetupWriteTextLog escribe la entrada, depende del valor del token de registro definido por el sistema.

    Para obtener más información sobre los tokens de registro, consulte Configuración y obtención de un token de registro para un subproceso.

  • Una de las categorías de eventos que se describen en Habilitación de categorías de eventos para un registro de texto. Si la categoría de eventos de la entrada está habilitada para el registro de texto, SetupWriteTextLog agrega la entrada al registro de texto; De lo contrario, SetupWriteTextLog no escribe la entrada en el registro de texto.

  • Valor de marca que es un OR bit a bit de constantes definidas por el sistema que especifican el nivel de evento, la profundidad de sangría y si se debe incluir una marca de tiempo. Los niveles de eventos se describen en Establecer el nivel de evento para un registro de texto. Si el nivel de evento establecido para el registro de texto es mayor o igual que el nivel de evento de la entrada, SetupWriteTextLog escribe una entrada de registro en el registro de texto; De lo contrario, SetupWriteTextLog no escribe una entrada de registro en el registro de texto. Mediante la sangría, los mensajes con formato se pueden organizar para facilitar la lectura y comprensión de la información de una sección. Para obtener más información, vea Escribir entradas de registro con sangría.

  • Cadena de formato compatible con printf que da formato tanto al mensaje como a la lista de variables separadas por comas que siguen a la cadena de formato.

  • Lista separada por comas de variables, cuyos valores tienen el formato de la cadena de formato compatible con printf.

Para obtener un ejemplo sobre cómo llamar a SetupWriteTextLog para registrar información sobre un evento que no es un error o una advertencia, vea Escribir una entrada de registro de información.

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