Dzienniki tekstowe SetupAPI

In Windows Vista and later versions of Windows, SetupAPI supports a device installation text log (SetupAPI.dev.log) and an application installation text log (SetupAPI.app.log). Menedżer Plug and Play (PnP) i SetupAPI zapisują wpisy w dzienniku tekstowym instalacji urządzenia w celu udostępnienia informacji o operacjach, które instalują urządzenia i sterowniki. Menedżer pnP i SetupAPI zapisują wpisy w dzienniku tekstowym instalacji aplikacji, które zawierają informacje o operacjach instalacji innych niż te, które odnoszą się konkretnie do instalacji urządzeń i sterowników.

Aplikacje instalacyjne, instalatory klas i współinstalatorzy mogą używać funkcji rejestrowania SetupAPI do zapisywania wpisów w dzienniku instalacji urządzenia i dziennika tekstowego instalacji aplikacji.

The SetupAPI text logs are ANSI plain text files, which are located by default in the %SystemRoot%\inf directory. Dzienniki tekstowe znajdują się w języku angielskim (standardowy).

Dzienniki tekstowe SetupAPI mają następujący format wewnętrzny:

• A log entry is one line in a text log.

• Pierwsze kilka wpisów dziennika zawiera nagłówek dziennika tekstowego zawierający informacje o architekturze systemu operacyjnego i komputera. Aby uzyskać więcej informacji, zobacz Format nagłówka dziennika tekstowego.

• Po nagłówku dziennika tekstowego znajduje się zero lub więcej sekcji dziennika tekstowego. Każda sekcja dziennika tekstu rejestruje zdarzenia podczas instalacji jednego urządzenia.

  Celem sekcji dziennika tekstowego jest grupowanie i formatowanie ciągłej sekwencji wpisów dziennika, które zawierają informacje o określonej operacji instalacji. Tworząc sekcje dziennika tekstu, menedżer PnP, SetupAPI lub niestandardowa aplikacja do instalacji mogą organizować wpisy dziennika w sposób koncepcyjnie zrozumiały. Na przykład menedżer PnP może utworzyć sekcję dziennika tekstowego w celu grupowania wszystkich wpisów dziennika, które mają zastosowanie do instalowania urządzenia. Sekcje dziennika tekstu są wyświetlane w dzienniku tekstowym w kolejności ich tworzenia. Aby uzyskać więcej informacji, zobacz Format sekcji dziennika tekstu.

• Dziennik tekstowy może zawierać wpisy dziennika, które nie są częścią nagłówka dziennika tekstowego lub sekcji dziennika tekstowego. Takie wpisy są skojarzone z operacjami, które nie są częścią żadnej konkretnej sekcji dziennika tekstowego, a ogólnie rzecz biorąc, są przeplatane między sekcjami dziennika tekstu. Wpisy dziennika, które nie są częścią sekcji dziennika tekstowego, są wyświetlane w dzienniku w tej samej kolejności, w jakiej są zapisywane w dzienniku tekstowym. Aby uzyskać więcej informacji na temat takich wpisów dziennika, zobacz Format wpisów dziennika, które nie są częścią sekcji dziennika tekstowego.