SetupInstallServicesFromInfSectionExA (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 SetupInstallServicesFromInfSectionEx melakukan operasi penginstalan dan penghapusan layanan yang ditentukan di bagian Penginstalan Layanan yang tercantum di bagian Layanan dari file INF.

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

Sintaksis

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            SectionName,
  [in] DWORD            Flags,
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
       PVOID            Reserved1,
       PVOID            Reserved2
);

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.

Bendera	Arti
SPSVCINST_TAGTOFRONT 0x001	Pindahkan tag layanan ke bagian depan daftar pesanan grupnya.
SPSVCINST_ASSOCSERVICE 0x002	Bagian AddService: Tandai layanan ini sebagai driver fungsi untuk perangkat yang diinstal.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Hapus entri log peristiwa untuk layanan tertentu.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Jangan timpa nama tampilan jika sudah ada.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Jangan timpa nilai jenis mulai jika layanan sudah ada.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Jangan timpa nilai kontrol kesalahan jika layanan sudah ada.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Jangan timpa grup urutan beban jika sudah ada.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	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.

[in] DeviceInfoSet

Penunjuk opsional ke handel ke kumpulan informasi perangkat. Untuk informasi selengkapnya, lihat panduan DDK Programmer. (Sumber daya ini mungkin tidak tersedia dalam beberapa bahasa

dan negara.)

[in] DeviceInfoData

Penunjuk opsional ke struktur SP_DEVINFO_DATA yang menyediakan konteks ke elemen tertentu dalam set yang deviceInfoSet tentukan. Untuk informasi selengkapnya, lihat panduan DDK Programmer. (Sumber daya ini mungkin tidak tersedia di beberapa bahasa dan negara.)

Reserved1

Dipesan.

Reserved2

Dipesan.

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 SetupInstallServicesFromInfSectionEx 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.

SetupInstallServicesFromInfSectionEx 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

Lihat juga

Functions

Gambaran Umum

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection