Fungsi WofSetFileDataLocation (wofapi.h)
Digunakan untuk mengubah file agar tidak didukung oleh file fisik menjadi file yang didukung oleh penyedia data sistem.
Sintaks
HRESULT WofSetFileDataLocation(
[in] HANDLE FileHandle,
[in] ULONG Provider,
[in] PVOID ExternalFileInfo,
[in] ULONG Length
);
Parameter
[in] FileHandle
Handel ke file yang dibuka dengan CreateFile atau API serupa.
[in] Provider
Menunjukkan penyedia mana yang mendukung file ini. Penyedia yang saat ini ditentukan adalah:
WOF_PROVIDER_WIM | Menunjukkan bahwa data untuk file harus diperoleh dari file WIM. Pada akses, data secara transparan diekstraksi dari file WIM dan disediakan untuk aplikasi. Jika konten file dimodifikasi, data didekompresi secara transparan dan file dipulihkan ke bentuk fisik yang sama dengan yang dimilikinya jika API ini tidak digunakan. |
WOF_PROVIDER_FILE | Menunjukkan bahwa data untuk file harus dikompresi dan disimpan dengan file itu sendiri. Pada akses, data secara transparan didekompresi dan disediakan untuk aplikasi. Jika konten file dimodifikasi, data didekompresi secara transparan dan file dipulihkan ke bentuk fisik yang sama dengan yang dimilikinya jika API ini tidak digunakan. Penyedia ini memerlukan Windows 10. |
[in] ExternalFileInfo
Menyediakan data khusus untuk penyedia yang ditentukan. Struktur data untuk setiap penyedia yang ditentukan adalah:
WOF_PROVIDER_WIM | WIM_EXTERNAL_FILE_INFO |
WOF_PROVIDER_FILE | WOF_FILE_COMPRESSION_INFO |
[in] Length
Menentukan panjang data spesifik penyedia, dalam byte. Ini harus sesuai dengan struktur yang ditentukan di atas:
WOF_PROVIDER_WIM | sizeof(WIM_EXTERNAL_FILE_INFO) |
WOF_PROVIDER_FILE | sizeof(WOF_FILE_COMPRESSION_INFO) |
Mengembalikan nilai
Fungsi ini mengembalikan HRESULT yang menunjukkan keberhasilan atau alasan kegagalan.
Keterangan
Saat menggunakan WOF_PROVIDER_FILE, operasi mungkin gagal dengan ERROR_COMPRESSION_NOT_BENEFICIAL. Ini menunjukkan bahwa upaya dilakukan untuk memadatkan data, tetapi tidak ada ruang disk yang disimpan, sehingga file tidak dikompresi. Untuk sebagian besar aplikasi, ini dapat diperlakukan sebagai kondisi keberhasilan.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | wofapi.h |
Pustaka | Wofutil.lib |
DLL | Wofutil.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk