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

FSCTL_SET_EXTERNAL_BACKING