Menyiapkan Log Teks API
Di Windows Vista dan versi Windows yang lebih baru, SetupAPI mendukung log teks penginstalan perangkat (SetupAPI.dev.log) dan log teks penginstalan aplikasi (SetupAPI.app.log). Manajer Plug and Play (PnP) dan entri tulis SetupAPI ke log teks penginstalan perangkat untuk memberikan informasi tentang operasi yang menginstal perangkat dan driver. Manajer PnP dan SetupAPI menulis entri ke log teks penginstalan aplikasi yang memberikan informasi tentang operasi penginstalan selain yang berkaitan secara khusus dengan penginstalan perangkat dan driver.
Aplikasi penginstalan, penginstal kelas, dan penginstal bersama dapat menggunakan fungsi pengelogan SetupAPI untuk menulis entri ke log penginstalan perangkat dan log teks penginstalan aplikasi.
Log teks SetupAPI adalah file teks biasa ANSI, yang terletak secara default di direktori %SystemRoot%\inf . Log teks berada dalam bahasa Inggris (Standar).
Log teks SetupAPI memiliki format internal berikut:
Entri log adalah satu baris dalam log teks.
Beberapa entri log pertama menyediakan header log teks yang berisi informasi tentang sistem operasi dan arsitektur komputer. Untuk informasi selengkapnya, lihat Format Header Log Teks.
Mengikuti header log teks adalah nol atau beberapa bagian log teks. Setiap bagian log teks merekam peristiwa selama penginstalan perangkat tunggal.
Tujuan dari bagian log teks adalah untuk mengelompokkan dan memformat urutan entri log yang berdampingan yang memberikan informasi tentang operasi penginstalan tertentu. Dengan membuat bagian log teks, manajer PnP, SetupAPI, atau aplikasi penginstalan kustom dapat mengatur entri log dengan cara yang bermakna secara konseptual. Misalnya, manajer PnP mungkin membuat bagian log teks untuk mengelompokkan semua entri log yang berlaku untuk menginstal perangkat. Bagian log teks muncul dalam log teks dalam urutan pembuatannya. Untuk informasi selengkapnya, lihat Format Bagian Log Teks.
Log teks dapat berisi entri log yang bukan bagian dari header log teks atau bagian log teks. Entri tersebut dikaitkan dengan operasi yang bukan bagian dari bagian log teks tertentu dan, secara umum, diselingi di antara bagian log teks. Entri log yang bukan bagian dari bagian log teks muncul di log dalam urutan yang sama di mana entri tersebut ditulis ke log teks. Untuk informasi selengkapnya tentang entri log tersebut, lihat Format Entri Log yang Bukan Bagian Dari Bagian Log Teks.