SetupInstallServicesFromInfSectionA (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupInstallServicesFromInfSection melakukan operasi penginstalan dan penghapusan layanan yang ditentukan di bagian Penginstalan Layanan yang tercantum di bagian Layanan file INF.

Pemanggil fungsi ini diperlukan untuk memiliki akses ke Service Control Manager, dan hak istimewa untuk memodifikasi layanan.

Sintaksis

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Parameter

[in] InfHandle

Handel ke file INF yang berisi bagian Layanan .

[in] SectionName

Nama bagian Layanan untuk diproses. Anda harus menggunakan string null-terminated.

[in] Flags

Kontrol untuk penginstalan setiap layanan di bagian yang ditentukan.

Bendera	Arti
SPSVCINST_TAGTOFRONT 0x001	Bagian AddService: pindahkan tag layanan ke bagian depan daftar pesanan grupnya.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Bagian DelService: hapus entri log peristiwa.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Bagian AddService: jangan timpa nama tampilan jika sudah ada.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Bagian AddService: jangan timpa nilai jenis mulai jika layanan sudah ada.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Bagian AddService: jangan timpa nilai kontrol kesalahan jika layanan sudah ada.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Bagian AddService: jangan timpa grup urutan beban jika sudah ada.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Bagian AddService: jangan timpa daftar dependensi jika sudah ada.
SPSVCINST_NOCLOBBER_DESCRIPTION 0x100	Bagian AddService: tandai layanan ini sebagai driver fungsi untuk perangkat yang diinstal.
SPSVCINST_STOPSERVICE 0x200	Bagian DelService: Hentikan layanan terkait yang ditentukan dalam entri sebelum menghapus layanan.
SPSVCINST_CLOBBER_SECURITY 0x400	Bagian AddService: Pengaturan keamanan layanan ditimpa jika layanan sudah ada di sistem. Catatan Tersedia dimulai dengan Windows Server 2003 dan Windows XP.
SPSVCINST_STARTSERVICE 0x800	Bagian AddService: Mulai layanan setelah layanan diinstal. Bendera ini tidak dapat digunakan untuk memulai layanan yang mengimplementasikan driver fungsi Plug and Play (PnP) atau driver filter untuk perangkat. Jika tidak, bendera ini dapat digunakan untuk memulai layanan mode pengguna atau mode kernel yang dikelola oleh Service Control Manager (SCM.) Catatan Tersedia dimulai dengan Windows Server 2008 dan Windows Vista.
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES 0x1000	Bagian AddService: Jangan timpa hak istimewa layanan yang diperlukan jika layanan sudah ada di sistem. Catatan Tersedia dimulai dengan Windows Server 2008 R2 dan Windows 7.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol. Fungsi ini memanggil SetLastError dengan ERROR_SUCCESS_REBOOT_REQUIRED jika reboot sistem diperlukan.

Jika fungsi gagal, nilai yang dikembalikan adalah 0 (nol). Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

Header setupapi.h mendefinisikan SetupInstallServicesFromInfSection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

SetupInstallServicesFromInfSection akan mencatat informasi diagnostik ke log teks penginstalan aplikasi SetupAPI. File log ini umumnya nonaktif secara default. Ini dapat diaktifkan dengan memodifikasi tingkat pengelogan umum bagian dari nilai LogLevel SetupAPI seperti yang dijelaskan di Mengatur Tingkat Pengelogan SETUPAPI. Untuk alasan performa, Anda hanya boleh mengaktifkan file log ini saat memecahkan masalah. Ketika file log diaktifkan, Anda dapat menemukannya di %windir%\inf\setupapi.app.log.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll
set API	ext-ms-win-setupapi-classinstallers-l1-1-2 (diperkenalkan di Windows 10, versi 10.0.14393)

Lihat juga

Functions

Gambaran Umum

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx