Función SetupWriteTextLogInfLine (setupapi.h)

  • Artículo

La función SetupWriteTextLogInfLine escribe una entrada de registro en un registro de texto setupAPI que contiene el texto de una línea de archivo INF especificada.

Sintaxis

WINSETUPAPI VOID SetupWriteTextLogInfLine(
  [in] SP_LOG_TOKEN LogToken,
  [in] DWORD        Flags,
  [in] HINF         InfHandle,
  [in] PINFCONTEXT  Context
);

Parámetros

[in] LogToken

Token de registro que es un token de registro definido por el sistema o que ha devuelto SetupGetThreadLogToken.

[in] Flags

Valor de tipo DWORD que es un OR bit a bit de valores de marca, que especifica lo siguiente:

  • Nivel de evento de la entrada de registro. Los niveles de evento que se pueden especificar para una entrada de registro son los mismos que los que se pueden habilitar para un registro de texto. Para obtener una lista de marcas de nivel de evento, consulte Establecimiento del nivel de evento para un registro de texto setupAPI.
  • Si se debe incluir una marca de tiempo en la entrada de registro. El valor de marca de marca de tiempo es TXTLOG_TIMESTAMP.
  • Cambio, si existe, a la profundidad de sangría de la sección y a la entrada de registro actual. Para obtener información sobre cómo usar las marcas de sangría, vea Escribir entradas de registro con sangría.

[in] InfHandle

Identificador del archivo INF que incluye la línea de texto que se va a escribir en el registro de texto. Un identificador de un archivo INF se obtiene llamando a SetupOpenInfFile, que se documenta en el SDK de plataforma.

[in] Context

Puntero a un contexto de archivo INF que especifica la línea de texto que se va a escribir en el registro de texto. Para obtener un contexto de archivo INF para una línea, se llama a las funciones SetupFindXxxLine . Para obtener información sobre los archivos INF y un contexto de archivo INF, consulte la información que se proporciona en el SDK de plataforma sobre el uso de archivos INF, la obtención de un contexto de archivo INF y la estructura INFCONTEXT.

Valor devuelto

None

Observaciones

SetupWriteTextLogInfLine escribe una entrada de registro en el formato siguiente:

entry-prefixtime-stampinf:indentationinf-line-text(inf-file-nameline-number)

Donde:

  • Los campos de prefijo de entrada y marca de tiempo son los mismos que los descritos en Formato de un cuerpo de sección de 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 número de línea contiene el número de línea de la línea especificada en el archivo INF.
El token de registro y las marcas que proporciona un llamador afectan al funcionamiento de SetupWriteTextLogInfLine de la misma manera que se describe para SetupWriteTextLog y SetupWriteTextLogError. Además, SetupWriteTextLogInfLine usa la categoría de eventos TXTLOG_INF.

Para obtener información general sobre cómo escribir entradas de registro en los registros de texto de SetupAPI, vea SetupAPI Logging (Windows Vista).

Para obtener más información sobre la operación de SetupWriteTextLogInfLine, vea Calling SetupWriteTextLogInfLine.

Para obtener más información sobre los distintos tipos de tokens de registro, consulte Tokens de registro.

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

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib
Archivo DLL Setupapi.dll

Consulte también

SetupGetThreadLogToken

SetupWriteTextLog

SetupWriteTextLogError