FSCTL_ENUM_OVERLAY kode kontrol
Kode kontrol FSCTL_ENUM_OVERLAY menghitung semua sumber data dari penyedia dukungan untuk volume tertentu.
Untuk melakukan operasi ini, panggil FltFsControlFile atau ZwFsControlFile dengan parameter berikut.
Parameter
Instance [in]: FltFsControlFile saja. Penunjuk instans buram untuk pemanggil. Parameter ini diperlukan dan tidak boleh NULL.
FileObject [in]: FltFsControlFile saja. Objek penunjuk file yang menentukan volume yang akan dilepas. Parameter ini diperlukan dan tidak boleh NULL.
FileHandle [in]: ZwFsControlFile saja. Handel file volume yang akan dilepas. Parameter ini diperlukan dan tidak boleh NULL.
FsControlCode [in]: Kode kontrol untuk operasi. Gunakan FSCTL_REMOVE_OVERLAY untuk operasi ini.
InputBuffer [in]: Penunjuk ke buffer input, yang harus berisi struktur WOF_EXTERNAL_INFO .
InputBufferLength [in]: Atur ke sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out]: Penunjuk ke buffer output yang akan menerima satu atau beberapa struktur WIM_PROVIDER_OVERLAY_ENTRY untuk sumber data yang mendukung volume.
OutputBufferLength [out]: Ukuran buffer yang diacu oleh OutputBuffer, dalam byte.
LengthReturned [out]: Menentukan jumlah byte yang ditulis ke dalam OutputBuffer pada penyelesaian yang berhasil.
Blok status
FltFsControlFile atau ZwFsControlFile mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, fungsi yang sesuai mungkin mengembalikan salah satu nilai NTSTATUS berikut.
| Kode | Makna |
|---|---|
| STATUS_ACCESS_DENIED | Pemohon tidak memiliki hak administratif. |
| STATUS_BUFFER_TOO_SMALL | Panjang buffer output yang diacu oleh OutputBuffer dan ditentukan oleh OutputBufferLength terlalu kecil. |
| STATUS_INTERNAL_ERROR | Volume yang diminta tidak dapat diakses. |
| STATUS_INVALID_DEVICE_REQUEST | Layanan dukungan tidak ada atau tidak dimulai. |
Keterangan
Saat menghitung sumber data untuk penyedia WIM, buffer output akan berisi array struktur WIM_PROVIDER_OVERLAY_ENTRY . Ukuran buffer output harus cukup besar untuk berisi semua entri overlay atau panggilan akan mengembalikan STATUS_BUFFER_TOO_SMALL.
Penyedia dukungan tambahan akan menentukan struktur enumerasi spesifik mereka sendiri.
Persyaratan
| Jenis persyaratan | Persyaratan |
|---|---|
| Klien minimum yang didukung | Pembaruan Windows 8.1 |
| Header | Ntifs.h (termasuk Ntifs.h atau Fltkernel.h) |