Fungsi SetupCopyErrorW (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 SetupCopyError menghasilkan kotak dialog untuk memberi tahu pengguna tentang kesalahan file salin.

Sintaksis

WINSETUPAPI UINT SetupCopyErrorW(
  [in]      HWND   hwndParent,
  [in]      PCWSTR DialogTitle,
  [in]      PCWSTR DiskName,
  [in]      PCWSTR PathToSource,
  [in]      PCWSTR SourceFile,
  [in]      PCWSTR TargetPathFile,
  [out]     UINT   Win32ErrorCode,
  [in]      DWORD  Style,
  [in, out] PWSTR  PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

Parameter

[in] hwndParent

Handel ke jendela induk untuk kotak dialog ini.

[in] DialogTitle

Penunjuk opsional ke string nulldihentikan yang menentukan judul kotak dialog.

Parameter ini dapat null. Jika parameter ini NULL, judul default "Kesalahan Salin" (dilokalkan ke bahasa sistem) digunakan.

[in] DiskName

Penunjuk opsional ke string nulldihentikan yang menentukan nama disk yang akan dimasukkan.

Parameter ini dapat null. Jika parameter ini NULL, nama default "(Tidak Diketahui)" (dilokalkan ke bahasa sistem) digunakan.

[in] PathToSource

Penunjuk ke komponen jalur file sumber tempat operasi gagal, misalnya, F:\x86.

Gunakan stringnull dihentikan.

[in] SourceFile

Penunjuk ke untai (karakter) null-dihentikan yang menentukan bagian nama file dari file tempat operasi gagal.

Gunakan stringnull dihentikan. Nama file ini ditampilkan jika pengguna mengklik tombol Detail atau Telusuri. Fungsi SetupCopyError mencari file yang menggunakan nama formulir terkompresinya. Oleh karena itu, Anda dapat meneruskan cmd.exe dan tidak khawatir bahwa file benar-benar ada seperti yang cmd.ex_ di media sumber.

[in] TargetPathFile

Penunjuk opsional ke string nulldihentikan yang menentukan jalur lengkap file target untuk mengganti nama dan menyalin operasi.

Gunakan stringnull dihentikan. Parameter ini dapat null. Jika TargetPathFile tidak ditentukan, "(Tidak Diketahui)" (dilokalkan ke bahasa sistem) digunakan.

[out] Win32ErrorCode

Jika terjadi kesalahan, anggota ini adalah Kode Kesalahan Sistem .

Jika kesalahan tidak terjadi, kesalahan akan NO_ERROR.

[in] Style

Bendera yang mengontrol pemformatan tampilan dan perilaku kotak dialog.

Parameter ini bisa menjadi salah satu bendera berikut.

IDF_NOBROWSE

Jangan tampilkan opsi telusuri.

IDF_NOSKIP

Jangan tampilkan opsi lewati file.

IDF_NODETAILS

Jangan tampilkan opsi detail.

Jika bendera ini diatur, parameter TargetPathFile dan Win32ErrorCode dapat dihilangkan.

IDF_NOCOMPRESSED

Jangan periksa versi terkompresi dari file sumber.

IDF_OEMDISK

Sumber operasi adalah disk yang disediakan produsen perangkat keras.

IDF_NOBEEP

Mencegah kotak dialog berbunyi untuk mendapatkan perhatian pengguna saat pertama kali muncul.

IDF_NOFOREGROUND

Mencegah kotak dialog menjadi jendela latar depan.

IDF_WARNIFSKIP

Memperingatkan pengguna yang melewatkan file dapat memengaruhi penginstalan.

[in, out] PathBuffer

Penunjuk opsional ke variabel di mana fungsi ini mengembalikan jalur (tidak termasuk nama file) dari lokasi yang ditentukan pengguna dalam kotak dialog. Anda harus menggunakan string null-terminated.

String null-dihentikan tidak boleh melebihi ukuran buffer tujuan. Untuk menghindari kesalahan buffer yang tidak mencukupi, PathBuffer harus setidaknya MAX_PATH. Untuk informasi selengkapnya, lihat bagian Keterangan dari topik ini.

[in] PathBufferSize

Ukuran buffer yang PathBuffer menunjuk ke, dalam karakter.

Ukuran buffer harus setidaknya MAX_PATH karakter, termasuk terminator null.

[in, out] PathRequiredSize

Penunjuk opsional ke variabel di mana fungsi ini mengembalikan ukuran buffer yang diperlukan, dalam karakter, termasuk terminator null .

Mengembalikan nilai

Fungsi mengembalikan salah satu nilai berikut.

Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Jika fungsi ini dipanggil dengan PathBuffer NULL dan PathBufferSize 0 (nol), fungsi menempatkan ukuran buffer yang diperlukan untuk menyimpan data yang ditentukan ke dalam variabel yang ditunjukkan oleh PathRequiredSize.

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR. Jika tidak, nilai yang dikembalikan adalah salah satu nilai yang ditentukan.

Untuk menghindari kesalahan buffer yang tidak mencukupi, ReturnBuffer harus setidaknya MAX_PATH.

Nota

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

SetupDeleteError

SetupPromptForDisk

SetupRenameError