Fungsi SetupRenameErrorA (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 RenameError menghasilkan kotak dialog yang memberi tahu pengguna tentang kesalahan penggantian nama file.

Sintaksis

WINSETUPAPI UINT SetupRenameErrorA(
  [in] HWND  hwndParent,
  [in] PCSTR DialogTitle,
  [in] PCSTR SourceFile,
  [in] PCSTR TargetFile,
  [in] UINT  Win32ErrorCode,
  [in] DWORD Style
);

Parameter

[in] hwndParent

Tangani ke jendela induk untuk kotak dialog ini.

[in] DialogTitle

Penunjuk ke string nulldihentikan yang menentukan judul kotak dialog kesalahan. Parameter ini mungkin null. Jika parameter ini NULL, judul default "Ganti Nama Kesalahan" (dilokalkan) digunakan.

[in] SourceFile

Penunjuk ke stringnull yang dihentikan yang menentukan jalur lengkap file sumber tempat operasi gagal.

[in] TargetFile

Penunjuk ke string nulldihentikan yang menentukan jalur lengkap file target tempat operasi gagal.

[in] Win32ErrorCode

Kode kesalahan sistem ditemui selama operasi file.

[in] Style

Menentukan pemformatan tampilan dan perilaku kotak dialog. Parameter ini bisa menjadi salah satu bendera berikut.

IDF_NOBEEP

Cegah kotak dialog berbunyi bip saat pertama kali muncul.

IDF_NOFOREGROUND

Cegah kotak dialog menjadi jendela latar depan.

Mengembalikan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

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

SetupCopyError

SetupDeleteError

SetupPromptForDisk