SetupAPI Text Logs
Dans Windows Vista et les versions ultérieures de Windows, SetupAPI prend en charge un journal texte d’installation d’appareil (SetupAPI.dev.log) et un journal de texte d’installation d’application (SetupAPI.app.log). Le gestionnaire Plug-and-Play (PnP) et les entrées d’écriture SetupAPI dans le journal texte d’installation de l’appareil pour fournir des informations sur les opérations qui installent les périphériques et les pilotes. Le gestionnaire PnP et setupAPI écrivent des entrées dans le journal texte d’installation de l’application qui fournissent des informations sur les opérations d’installation autres que celles qui concernent spécifiquement les installations de périphériques et de pilotes.
Les applications d’installation, les programmes d’installation de classes et les co-programmes d’installation peuvent utiliser les fonctions de journalisation SetupAPI pour écrire des entrées dans le journal d’installation de l’appareil et dans le journal de texte d’installation de l’application.
Les journaux de texte SetupAPI sont des fichiers de texte brut ANSI, qui se trouvent par défaut dans le répertoire %SystemRoot%\inf . Les journaux de texte sont en anglais (Standard).
Les journaux de texte SetupAPI ont le format interne suivant :
Une entrée de journal correspond à une ligne dans un journal texte.
Les premières entrées de journal fournissent un en-tête de journal texte qui contient des informations sur le système d’exploitation et l’architecture de l’ordinateur. Pour plus d’informations, consultez Format d’un en-tête de journal de texte.
Après l’en-tête du journal de texte, vous trouverez zéro ou plusieurs sections de journal de texte. Chaque section du journal de texte enregistre les événements au cours d’une installation d’un seul appareil.
L’objectif d’une section de journal texte est de regrouper et de mettre en forme une séquence contiguë d’entrées de journal qui fournissent des informations sur une opération d’installation particulière. En créant des sections de journal texte, le gestionnaire PnP, SetupAPI ou une application d’installation personnalisée peut organiser les entrées de journal d’une manière conceptuelle significative. Par exemple, le gestionnaire PnP peut créer une section de journal texte pour regrouper toutes les entrées de journal qui s’appliquent à l’installation d’un appareil. Les sections du journal de texte s’affichent dans un journal de texte dans l’ordre dans lequel elles sont créées. Pour plus d’informations, consultez Format d’une section journal de texte.
Un journal texte peut contenir des entrées de journal qui ne font pas partie de l’en-tête du journal texte ou d’une section du journal texte. Ces entrées sont associées à des opérations qui ne font pas partie d’une section de journal de texte particulière et, en général, sont entrelacées entre les sections du journal texte. Les entrées de journal qui ne font pas partie d’une section de journal de texte s’affichent dans le journal dans l’ordre dans lequel elles sont écrites dans le journal texte. Pour plus d’informations sur ces entrées de journal, consultez Format des entrées de journal qui ne font pas partie d’une section de journal de texte.