Fungsi SetupQueueCopyA (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 SetupQueueCopy menambahkan satu operasi penyalinan file ke antrean file penyiapan.

Sintaksis

WINSETUPAPI BOOL SetupQueueCopyA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    SourceRootPath,
  [in] PCSTR    SourcePath,
  [in] PCSTR    SourceFilename,
  [in] PCSTR    SourceDescription,
  [in] PCSTR    SourceTagfile,
  [in] PCSTR    TargetDirectory,
  [in] PCSTR    TargetFilename,
  [in] DWORD    CopyStyle
);

Parameter

[in] QueueHandle

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

[in] SourceRootPath

Penunjuk ke stringnull yang dihentikan yang menentukan akar sumber untuk salinan ini, seperti A:.

[in] SourcePath

Penunjuk ke untainull yang menentukan jalur relatif terhadap SourceRootPath tempat file dapat ditemukan. Parameter ini mungkin null.

[in] SourceFilename

Penunjuk ke untai (karakter) nullyang dihentikan yang menentukan bagian nama file dari file yang akan disalin.

[in] SourceDescription

Penunjuk ke untainull yang menentukan deskripsi media sumber yang akan digunakan selama perintah disk. Parameter ini dapat null.

[in] SourceTagfile

Penunjuk ke stringnull yang dihentikan yang menentukan file tag yang kehadirannya di SourceRootPath menunjukkan keberadaan media sumber. Parameter ini mungkin null. Jika tidak ditentukan, file itu sendiri akan digunakan sebagai file tag jika diperlukan.

[in] TargetDirectory

Penunjuk ke string nulldihentikan yang menentukan direktori tempat file akan disalin.

[in] TargetFilename

Penunjuk ke untai (karakter) nullyang dihentikan yang menentukan nama file target. Parameter ini mungkin null. Jika tidak ditentukan, file target akan memiliki nama yang sama dengan file sumber.

[in] CopyStyle

Menentukan perilaku operasi penyalinan file. Parameter ini mungkin merupakan kombinasi dari nilai berikut.

SP_COPY_DELETESOURCE

Hapus file sumber setelah salinan berhasil. Pemanggil tidak diberi tahu jika penghapusan gagal.

SP_COPY_REPLACEONLY

Salin file hanya jika melakukannya akan menimpa file di jalur tujuan. Pemanggil tidak diberi tahu.

SP_COPY_NEWER_OR SAMA

Periksa setiap file yang sedang disalin untuk melihat apakah sumber daya versinya menunjukkan bahwa file tersebut adalah versi yang sama atau tidak lebih baru dari salinan yang ada pada target.

Informasi versi file yang digunakan selama pemeriksaan versi adalah yang ditentukan dalam dwFileVersionMS dan dwFileVersionLS anggota struktur VS_FIXEDFILEINFO, seperti yang diisi oleh fungsi versi. Jika salah satu file tidak memiliki sumber daya versi, atau jika memiliki informasi versi yang identik, file sumber dianggap lebih baru.

Jika file sumber tidak sama dalam versi atau yang lebih baru, dan CopyMsgHandler ditentukan, pemanggil akan diberi tahu dan dapat membatalkan salinan. Jika CopyMsgHandler tidak ditentukan, file tidak disalin.

SP_COPY_NEWER_ONLY

Periksa setiap file yang sedang disalin untuk melihat apakah sumber daya versinya menunjukkan bahwa file tersebut tidak lebih baru dari salinan yang ada pada target. Jika file sumber lebih baru tetapi tidak sama dalam versi dengan target yang ada, file akan disalin.

SP_COPY_NOOVERWRITE

Periksa apakah file target ada, dan, jika demikian, beri tahu pemanggil yang mungkin mem-veto salinan. Jika copyMsgHandler tidak ditentukan, file tidak akan ditimpa.

SP_COPY_NODECOMP

Jangan dekompresi file. Ketika bendera ini diatur, file target tidak diberi bentuk nama sumber yang tidak dikompresi (jika sesuai). Misalnya, menyalin f:\x86\cmd.ex_ ke \install\temp menghasilkan file target \install\temp\cmd.ex_. Jika bendera SP_COPY_NODECOMP tidak ditentukan, file akan didekompresi dan target akan dipanggil \install\temp\cmd.exe. Bagian nama file dari DestinationName, jika ditentukan, dilucuti dan diganti dengan nama file file sumber. Ketika SP_COPY_NODECOMP ditentukan, tidak ada informasi bahasa atau versi yang dapat diperiksa.

SP_COPY_LANGUAGEAWARE

Periksa setiap file yang disalin untuk melihat apakah bahasanya berbeda dari bahasa file yang ada yang sudah ada pada target. Jika demikian, dan CopyMsgHandler ditentukan, pemanggil akan diberi tahu dan dapat membatalkan salinan. Jika CopyMsgHandler tidak ditentukan, file tidak disalin.

SP_COPY_SOURCE_ABSOLUTE

SourceFile adalah jalur sumber lengkap. Jangan mencarinya di bagian SourceDisksNames file INF.

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot adalah bagian jalur lengkap dari file sumber. Abaikan sumber relatif yang ditentukan di bagian SourceDisksNames dari file INF untuk media sumber tempat file berada. Bendera ini diabaikan jika SP_COPY_SOURCE_ABSOLUTE ditentukan.

SP_COPY_FORCE_IN_USE

Jika target ada, berulah seolah-olah sedang digunakan dan antrekan file untuk disalin pada boot ulang sistem berikutnya.

SP_COPY_IN_USE_NEEDS_REBOOT

Jika file sedang digunakan selama operasi salin, beri tahu pengguna bahwa sistem perlu di-boot ulang.

SP_COPY_NOSKIP

Jangan beri pengguna opsi untuk melewati file.

SP_COPY_FORCE_NOOVERWRITE

Periksa apakah file target ada, dan, jika demikian, file tidak ditimpa. Pemanggil tidak diberi tahu.

SP_COPY_FORCE_NEWER

Periksa setiap file yang sedang disalin untuk melihat apakah sumber daya versinya (atau stempel waktu untuk file non-gambar) menunjukkan bahwa file tersebut tidak lebih baru dari salinan yang ada pada target. Jika file yang disalin bukan yang lebih baru, file tidak disalin. Pemanggil tidak diberi tahu.

SP_COPY_WARNIFSKIP

Jika pengguna mencoba melewati file, peringatkan mereka bahwa melompati file dapat memengaruhi penginstalan. (Digunakan untuk file penting sistem.)

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

Jika direktori UNC ditentukan sebagai direktori target operasi penyalinan file, Anda harus memastikannya ada sebelum antrean diterapkan. Fungsi penyiapan tidak memeriksa keberadaan dan tidak membuat direktori UNC. Jika direktori UNC target tidak ada, salinan file akan gagal.

Nota

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

SetupQueueDefaultCopy

SetupQueueDelete

SetupQueueRename