Llamar a SetupWriteTextLogInfLine

Una aplicación puede llamar a SetupWriteTextLogInfLine para escribir una entrada de registro en un registro de texto setupAPI que contiene el texto de una línea de archivo INF especificada.

Para llamar a SetupWriteTextLogInfLine, 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, SetupWriteTextLogInfLine escribe la entrada de registro en esa sección. De lo contrario, SetupWriteTextLogInfLine 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 SetupWriteTextLogInfLine escribe una entrada de registro y en qué registro de texto SetupWriteTextLogInfLine 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.

• 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 evento 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, SetupWriteTextLogInfLine escribe una entrada de registro en el registro de texto. De lo contrario, SetupWriteTextLogInfLine no escribe una entrada de registro en el registro de texto. Mediante el uso de 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.

• Identificador del archivo INF que contiene la línea de archivo INF.

• Contexto de la línea de archivo INF.

SetupWriteTextLogInfLine escribe una entrada de registro en el siguiente formato:

entry_prefix time_stampinf:indentation inf-line-text(inf-file-nameline-number)

Donde:

• Los campos entry_prefix, marca de tiempo y sangría son los mismos que los descritos en Formato de un cuerpo de sección de registro de texto.

• El campo inf: especifica la categoría de evento TXTLOG_INF. Las categorías de eventos se describen en Habilitación de categorías de eventos para un registro de texto.

• El campo inf-line-text contiene el texto de la línea de archivo INF especificada.

• El campo inf-file-name contiene el nombre del archivo INF que contiene la línea de archivo INF especificada.

• El campo de línea indica que lo siguiente es un número de línea en el archivo INF.

• El campo número de línea contiene el número de línea de la línea especificada en el archivo INF.

En el ejemplo siguiente se muestra cómo una aplicación suele registrar el texto de una línea INF en un registro de texto. La línea INF de este ejemplo es una línea AddReg inf. La aplicación llama a SetupWriteTextLogInfLine, proporcionando los siguientes valores de parámetro de entrada:

• LogToken se establece en un token de registro devuelto por SetupGetThreadLogToken o en un token de registro definido por el sistema.

• LogFlags se establece en TXTLOG_DETAILS. En este ejemplo no se incluye una marca de tiempo ni se cambia la profundidad de sangría. En el ejemplo, la profundidad de sangría es cinco espacios de texto monoespacio.

• InfHandle se establece en un identificador del archivo INF hidserv.inf. Este identificador se obtiene mediante una llamada a la función SetupOpenInfFile , que se documenta en el SDK de plataforma.

• El contexto se establece en el contexto del archivo INF de la línea de archivo INF que contiene el texto "AddReg=HidServ_AddService_AddReg". Se obtiene un contexto de archivo INF para la línea mediante una llamada a las funciones SetupFindXxxLine , que se documentan en el SDK de plataforma.

Los valores de LogToken y LogFlags afectan al funcionamiento de SetupWriteTextLogInfLine de la misma manera que se describe para SetupWriteTextLog. Además, SetupWriteTextLogInfLine usa el TXTLOG_INF del catálogo de eventos.

En este ejemplo, a continuación se muestra el tipo de entrada de registro que SetupWriteTextLogInfLine escribiría en un registro de texto:

   inf:      AddReg=HidServ_AddService_AddReg  (hidserv.inf line 98)