SetupCreateDiskSpaceListA (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 SetupCreateDiskSpaceList membuat daftar ruang disk.

Sintaksis

WINSETUPAPI HDSKSPC SetupCreateDiskSpaceListA(
  [in] PVOID Reserved1,
  [in] DWORD Reserved2,
  [in] UINT  Flags
);

Parameter

[in] Reserved1

Tidak digunakan, harus nol.

[in] Reserved2

Tidak digunakan, harus nol.

[in] Flags

Parameter ini bisa menjadi nilai berikut.

SPDSL_IGNORE_DISK

Operasi file yang ditambahkan ke daftar akan mengabaikan file yang sudah ada pada disk. Misalnya, jika disk berisi file 5000-byte, C:\MyDir\MyFile, dan Anda menambahkan operasi Salin ke daftar ruang disk untuk versi baru, C:\MyDir\MyFile, yaitu 6500 byte, ruang yang diperlukan akan menjadi 6500 byte (bukan 1500 byte, yang merupakan nilai yang dikembalikan jika Anda tidak mengatur SPDSL_IGNORE_DISK).

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan handel ke daftar ruang disk.

Jika fungsi gagal, fungsi akan mengembalikan null. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

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

SetupDestroyDiskSpaceList