Fungsi SetupQueueRenameA (setupapi.h)

Artikel
20/11/2024

[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.

Sintaksis

WINSETUPAPI BOOL SetupQueueRenameA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    SourcePath,
  [in] PCSTR    SourceFilename,
  [in] PCSTR    TargetPath,
  [in] PCSTR    TargetFilename
);

Parameter

[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 SourceFileName tidak ditentukan, SourcePath diasumsikan sebagai jalur lengkap.

[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.

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

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.

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

SetupQueueCopy

SetupQueueDelete

SetupQueueRenameSection

Bagikan melalui