Fungsi SetupDecompressOrCopyFileW (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 SetupDecompressOrCopyFile menyalin file, mendekompresinya jika perlu.

Jika file disalin, pemanggil fungsi ini diperlukan memiliki hak istimewa untuk menulis ke direktori target.

Sintaksis

WINSETUPAPI DWORD SetupDecompressOrCopyFileW(
  [in] PCWSTR SourceFileName,
  [in] PCWSTR TargetFileName,
  [in] PUINT  CompressionType
);

Parameter

[in] SourceFileName

Nama file file yang akan disalin. Anda harus menggunakan stringnullyang dihentikan . Parameter ini dapat null. Jika CompressionType tidak ditentukan dan fungsi SetupDecompressOrCopyFile tidak menemukan file yang ditentukan dalam SourceFileName, fungsi mencari file dengan nama "bentuk terkompresi" alternatif. Misalnya, jika file F:\x86\cmd.exe dan tidak ditemukan, fungsi mencari F:\x86\cmd.ex_ dan, jika tidak ditemukan, F:\x86\cmd.ex$ dicari. Jika CompressionType ditentukan, tidak ada pemrosesan tambahan yang dilakukan pada nama file; file harus ada persis seperti yang ditentukan atau fungsi gagal.

[in] TargetFileName

Nama yang tepat dari file target yang akan dibuat dengan mendekompresi atau menyalin file sumber. Anda harus menggunakan stringnullyang dihentikan .

[in] CompressionType

Penunjuk opsional ke jenis kompresi yang digunakan pada file sumber. Anda dapat menentukan jenis kompresi dengan memanggil SetupGetFileCompressionInfo. Jika nilai ini FILE_COMPRESSION_NONE, file disalin (tidak didekompresi) terlepas dari pemadatan apa pun yang digunakan pada sumbernya. Jika CompressionType tidak ditentukan, rutinitas ini menentukan jenis kompresi secara otomatis.

Mengembalikan nilai

Fungsi SetupDecompressOrCopyFile mengembalikan kode kesalahan sistem yang menunjukkan hasil operasi.

Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

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

SetupGetFileCompressionInfo