Fungsi SetupQuerySpaceRequiredOnDriveA (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 SetupQuerySpaceRequiredOnDrive memeriksa daftar ruang disk untuk menentukan ruang yang diperlukan untuk melakukan semua operasi file yang tercantum untuk drive tertentu.

Sintaksis

WINSETUPAPI BOOL SetupQuerySpaceRequiredOnDriveA(
  [in]  HDSKSPC  DiskSpace,
  [in]  PCSTR    DriveSpec,
  [out] LONGLONG *SpaceRequired,
  [in]  PVOID    Reserved1,
  [in]  UINT     Reserved2
);

Parameter

[in] DiskSpace

Handel ke daftar ruang disk.

[in] DriveSpec

Penunjuk ke string yang dihentikan null yang menentukan drive tempat informasi spasi akan dikembalikan.

Ini harus dalam bentuk "x:" atau "\server\share".

[out] SpaceRequired

Jika fungsi berhasil, parameter ini menerima jumlah ruang tambahan yang diperlukan untuk memproses semua operasi file yang tercantum dalam daftar ruang disk untuk drive yang DriveSpec tentukan.

Fungsi SetupQuerySpaceRequiredOnDrive menghitung ruang tambahan yang diperlukan pada drive target dengan memeriksa versi file yang sudah ada sebelumnya pada drive target.

Misalnya, jika operasi file menyalin file 2000-byte, FIRST.EXE, ke direktori, C:\MYPROG, fungsi SetupQuerySpaceRequiredOnDrive secara otomatis memeriksa versi file tersebut yang sudah ada sebelumnya di direktori tersebut. Jika versi C:\MYPROG\FIRST.EXE yang sudah ada sebelumnya memiliki ukuran file 500 byte, ruang tambahan yang diperlukan pada drive C untuk operasi tersebut adalah 1500 byte.

Nilai yang diterima bisa 0 (nol) atau angka negatif, jika ruang tambahan tidak diperlukan, atau jika ruang dibebaskan pada drive target.

Jika FIRST.EXE dalam contoh sebelumnya sedang dihapus dari drive C, jumlah ruang yang diperlukan adalah 2000 byte, atau ruang yang dikosongkan pada drive C.

Jika versi yang sudah ada sebelumnya memiliki ukuran file 5000 byte, maka ruang disk yang diperlukan untuk menggantinya dengan FIRST.EXE 2000 byte adalah 3000 byte.

Ukuran file dibulatkan ke batas kluster disk.

[in] Reserved1

Dipesan; harus 0 (nol).

[in] Reserved2

Dipesan; harus 0 (nol).

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian adalah nilai bukan nol dan SpaceRequired menerima jumlah ruang yang diperlukan oleh operasi file yang tercantum dalam daftar ruang disk saat ini.

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

Mengembalikan kode	Deskripsi
ERROR_INVALID_DRIVE	Kandar yang ditentukan tidak ada pada daftar ruang disk.
ERROR_INVALID_HANDLE	Handel DiskSpace yang ditentukan tidak valid.
ERROR_INVALID_PARAMETER	String DriveSpec yang ditentukan tidak valid.

Komentar

Nota

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

SetupQueryDrivesInDiskSpaceList