SetupRemoveSectionFromDiskSpaceListA (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 SetupRemoveSectionFromDiskSpaceList menghapus operasi penghapusan atau penyalinan file yang tercantum di bagian Salin File file INF dari daftar ruang disk.

Sintaksis

WINSETUPAPI BOOL SetupRemoveSectionFromDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCSTR   SectionName,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

Parameter

[in] DiskSpace

Tangani ke daftar ruang disk.

[in] InfHandle

Tangani ke file INF terbuka yang berisi bagian SourceDisksFiles . Jika ListInfHandle tidak ditentukan, file INF ini juga harus berisi bagian yang ditentukan oleh SectionName.

[in] ListInfHandle

Handel opsional ke file INF terbuka yang berisi bagian untuk dihapus dari daftar ruang disk. Jika tidak, InfHandle harus berisi bagian yang ditentukan oleh SectionName.

[in] SectionName

Penunjuk ke string yang dihentikan null yang menentukan nama Salin File atau Menghapus File untuk dihapus dari daftar ruang disk.

[in] Operation

Operasi file untuk 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 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

Operasi file yang dihapus oleh fungsi SetupRemoveSectionFromDiskSpaceList biasanya yang telah ditambahkan ke daftar dengan menggunakan fungsi SetupAddSectionToDiskSpaceList , meskipun ini bukan persyaratan. Fungsi SetupRemoveSectionFromDiskSpaceList mengabaikan file di bagian INF yang tidak tercantum dalam daftar ruang disk.

Fungsi ini memerlukan file INF Windows. Beberapa format file INF yang lebih lama mungkin tidak didukung.

Nota

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

SetupAddSectionToDiskSpaceList

SetupRemoveFromDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList