Fungsi SetupQueueRenameA (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 SetupQueueRename menempatkan operasi penggantian nama file individual pada antrean file penyiapan.
WINSETUPAPI BOOL SetupQueueRenameA(
[in] HSPFILEQ QueueHandle,
[in] PCSTR SourcePath,
[in] PCSTR SourceFilename,
[in] PCSTR TargetPath,
[in] PCSTR TargetFilename
);
[in] QueueHandle
Tangani ke antrean file penyetelan, seperti yang dikembalikan oleh SetupOpenFileQueue.
[in] SourcePath
Penunjuk ke string yang dihentikan null yang menentukan jalur sumber file yang akan diganti namanya. Jika
[in] SourceFilename
Penunjuk ke string null-terminated yang menentukan bagian nama file dari file yang akan diganti namanya. Jika tidak ditentukan, SourcePath adalah jalur lengkap.
[in] TargetPath
Penunjuk ke string null-terminated yang menentukan direktori target. Ketika parameter ini ditentukan, operasi ganti nama sebenarnya adalah operasi pemindahan. Jika TargetPath tidak ditentukan, file akan diganti namanya tetapi tetap berada di lokasinya saat ini.
[in] TargetFilename
Penunjuk ke string null-terminated yang menentukan nama baru untuk file sumber.
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.
Karena operasi penggantian nama diasumsikan terjadi pada media tetap, pengguna tidak akan diminta ketika antrean dilakukan.
Catatan
Header setupapi.h mendefinisikan SetupQueueRename 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.
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 |
Gambaran Umum
SetupQueueDelete
SetupQueueRenameSection