SetupRemoveFromDiskSpaceListA (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 SetupRemoveFromDiskSpaceList menghapus operasi penghapusan atau penyalinan file dari daftar ruang disk.

Sintaksis

WINSETUPAPI BOOL SetupRemoveFromDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] PCSTR   TargetFilespec,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Parameter

[in] DiskSpace

Menangani ke daftar ruang disk.

[in] TargetFilespec

Penunjuk ke string yang dihentikan null yang menentukan nama file file yang akan dihapus dari daftar ruang disk. Ini biasanya merupakan jalur yang sepenuhnya memenuhi syarat. Jika tidak, jalur harus relatif terhadap direktori saat ini.

[in] Operation

Operasi file yang akan dihapus dari daftar. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
FILEOP_DELETE	Operasi penghapusan file.
FILEOP_COPY	Operasi penyalinan file.

[in] Reserved1

Harus nol.

[in] Reserved2

Harus nol.

Mengembalikan nilai

Jika file tidak ada dalam daftar, fungsi SetupRemoveFromDiskSpaceList mengembalikan nilai bukan nol dan GetLastError mengembalikan ERROR_INVALID_DRIVE atau ERROR_INVALID_NAME. Jika file berada dalam daftar maka setelah berhasil, rutinitas mengembalikan nilai bukan nol dan GetLastError mengembalikan NO_ERROR.

Jika rutinitas gagal karena alasan lain, rutinitas mengembalikan nol dan GetLastError mengembalikan informasi kesalahan yang diperluas.

Komentar

Nota

Header setupapi.h mendefinisikan SetupRemoveFromDiskSpaceList 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.

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

SetupAddToDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList

SetupRemoveSectionFromDiskSpaceList