Fungsi SetupAddToDiskSpaceListA (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 SetupAddToDiskSpaceList menambahkan satu operasi hapus atau salin ke daftar ruang disk. Untuk menambahkan semua operasi file di bagian file INF, gunakan SetupAddSectionToDiskSpaceList, atau SetupAddInstallSectionToDiskSpaceList.

Pemadatan disk target diabaikan oleh fungsi ini. File diasumsikan untuk menempati ukuran penuhnya pada disk target.

Sintaksis

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

Parameter

[in] DiskSpace

Tangani ke daftar ruang disk.

[in] TargetFilespec

Nama file file yang akan ditambahkan ke daftar ruang disk. Anda harus menggunakan string null-terminated yang menentukan jalur yang sepenuhnya memenuhi syarat. Jika tidak, jalur harus relatif terhadap direktori saat ini.

[in] FileSize

Ukuran file yang tidak dikompresi karena akan ada di direktori target, dalam byte. Anda dapat menggunakan SetupGetSourceFileSize untuk mengambil informasi ini dari file INF. Parameter ini diabaikan untuk operasi FILEOP_DELETE.

[in] Operation

Operasi file yang akan ditambahkan ke 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

Nota

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