Fungsi SetupQueueDeleteA (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 SetupQueueDelete menempatkan operasi penghapusan file individual pada antrean file penyiapan.

Sintaksis

WINSETUPAPI BOOL SetupQueueDeleteA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    PathPart1,
  [in] PCSTR    PathPart2
);

Parameter

[in] QueueHandle

Tangani ke antrean file penyetelan, seperti yang dikembalikan oleh SetupOpenFileQueue.

[in] PathPart1

Penunjuk ke string nulldihentikan yang menentukan bagian pertama dari jalur file yang akan dihapus. Jika PathPart2NULL, PathPart1 adalah jalur lengkap file yang akan dihapus.

[in] PathPart2

Penunjuk ke string null-dihentikan yang menentukan bagian kedua dari jalur file yang akan dihapus. Parameter ini mungkin null. Ini ditambahkan ke PathPart1 untuk membentuk jalur lengkap file yang akan dihapus. Fungsi memeriksa dan menciutkan pemisah jalur duplikat saat menggabungkan PathPart1 dan PathPart2.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

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

Komentar

Karena operasi penghapusan diasumsikan terjadi pada media tetap, pengguna tidak akan diminta ketika antrean dilakukan.

Nota

Header setupapi.h mendefinisikan SetupQueueDelete sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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.

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

SetupQueueCopy

SetupQueueDeleteSection

SetupQueueRename