Registros de texto de SetupAPI

En Windows Vista y versiones posteriores de Windows, SetupAPI admite un registro de texto de instalación de dispositivo (SetupAPI.dev.log) y un registro de texto de instalación de la aplicación (SetupAPI.app.log). El administrador de Plug and Play (PnP) y setupAPI escriben entradas en el registro de texto de instalación del dispositivo para proporcionar información sobre las operaciones que instalan dispositivos y controladores. El administrador de PnP y SetupAPI escriben entradas en el registro de texto de instalación de la aplicación que proporcionan información sobre las operaciones de instalación distintas de las que pertenecen específicamente a las instalaciones de dispositivos y controladores.

Las aplicaciones de instalación, los instaladores de clase y los coinstaladores pueden usar las funciones de registro setupAPI para escribir entradas en el registro de instalación del dispositivo y en el registro de texto de instalación de la aplicación.

Los registros de texto setupAPI son archivos de texto sin formato ANSI, que se encuentran de forma predeterminada en el directorio %SystemRoot%\inf . Los registros de texto están en inglés (estándar).

Los registros de texto setupAPI tienen el siguiente formato interno:

• Una entrada de registro es una línea de un registro de texto.

• Las primeras entradas de registro proporcionan un encabezado de registro de texto que contiene información sobre el sistema operativo y la arquitectura del equipo. Para obtener más información, vea Formato de un encabezado de registro de texto.

• Después del encabezado de registro de texto hay cero o más secciones de registro de texto. Cada sección de registro de texto registra los eventos durante una única instalación de dispositivo.

  El propósito de una sección de registro de texto es agrupar y dar formato a una secuencia contigua de entradas de registro que proporcionan información sobre una operación de instalación determinada. Al crear secciones de registro de texto, el administrador de PnP, SetupAPI o una aplicación de instalación personalizada puede organizar las entradas de registro de una manera conceptualmente significativa. Por ejemplo, el administrador de PnP podría crear una sección de registro de texto para agrupar todas las entradas de registro que se aplican a la instalación de un dispositivo. Las secciones de registro de texto aparecen en un registro de texto en el orden en que se crean. Para obtener más información, vea Formato de una sección de registro de texto.

• Un registro de texto puede contener entradas de registro que no forman parte del encabezado de registro de texto o de una sección de registro de texto. Estas entradas están asociadas a operaciones que no forman parte de ninguna sección de registro de texto determinada y, en general, se intercalan entre secciones de registro de texto. Las entradas de registro que no forman parte de una sección de registro de texto aparecen en el registro en el mismo orden en que se escriben en el registro de texto. Para obtener más información sobre estas entradas de registro, vea Formato de entradas de registro que no forman parte de una sección de registro de texto.