Fungsi SetupQueueRenameSectionA (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 SetupQueueRenameSection mengantrekan bagian dalam file INF untuk penggantian nama. Bagian harus dalam format bagian daftar ganti nama yang benar dan file INF harus berisi bagian DestinationDirs .

Sintaksis

WINSETUPAPI BOOL SetupQueueRenameSectionA(
  [in] HSPFILEQ QueueHandle,
  [in] HINF     InfHandle,
  [in] HINF     ListInfHandle,
  [in] PCSTR    Section
);

Parameter

[in] QueueHandle

Tangani ke antrean file penyetelan, seperti yang dikembalikan oleh SetupOpenFileQueue.

[in] InfHandle

Tangani ke file INF yang berisi bagian DestinationDirs . Jika ListInfHandle tidak ditentukan, InfHandle berisi nama bagian.

[in] ListInfHandle

Handel opsional ke file INF yang berisi bagian untuk diantrekan untuk penggantian nama. Jika ListInfHandle tidak ditentukan, InfHandle diasumsikan berisi nama bagian.

[in] Section

Nama bagian yang akan diantrekan untuk penggantian nama.

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

Anda tidak dapat mengantre pemindahan file dengan SetupQueueRenameSection karena bentuk bagian batas bagian daftar ganti nama mengganti nama menjadi dalam direktori yang sama.

Fungsi ini memerlukan file INF Windows. Beberapa format file INF yang lebih lama mungkin tidak didukung.

Nota

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

SetupQueueCopySection

SetupQueueDeleteSection

SetupQueueRename