Bagikan melalui

FSCTL_ENUM_EXTERNAL_BACKING kode kontrol

  • Artikel

Kode kontrol FSCTL_ENUM_EXTERNAL_BACKING dimulai atau melanjutkan enumerasi file pada volume yang memiliki sumber dukungan. Untuk setiap keberhasilan penyelesaian permintaan, pengidentifikasi untuk file yang didukung dikembalikan. Semua file yang didukung dijumlahkan terlepas dari penyedia eksternal mana yang mendukungnya. Permintaan FSCTL_ENUM_EXTERNAL_BACKING berturut-turut diperlukan untuk menghitung semua file yang didukung pada volume.

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_ENUM_EXTERNAL_BACKING untuk operasi ini.

  • InputBuffer [in]: Tidak ada. Atur ke NULL.

  • InputBufferLength [in]: Atur ke 0.

  • OutputBuffer [out]: Penunjuk ke buffer output, yang harus memiliki ukuran yang cukup besar untuk menerima satu atau beberapa struktur WOF_EXTERNAL_FILE_ID .

  • OutputBufferLength [out]: Ukuran buffer output yang diacu oleh OutputBuffer. OutputBufferLength harus >= sizeof(WOF_EXTERNAL_FILE_ID).

  • 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_NO_MORE_FILES Tidak ada lagi file pada volume yang memiliki sumber cadangan.
STATUS_INTERNAL_ERROR Volume yang diminta tidak dapat diakses.
STATUS_INVALID_DEVICE_REQUEST Layanan dukungan tidak ada atau tidak dimulai.

Keterangan

Struktur WOF_EXTERNAL_FILE_ID yang dikembalikan di OutputBuffer berisi pengidentifikasi file unik untuk file yang didukung. Struktur didefinisikan dalam ntifs.h sebagai berikut.

typedef struct _WOF_EXTERNAL_FILE_ID {
    FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;

Permintaan FSCTL_ENUM_EXTERNAL_BACKING dikeluarkan secara berturut-turut untuk mengambil pengidentifikasi untuk setiap file pada volume yang memiliki sumber pendukung. Ketika semua file dijumlahkan, kode status STATUS_NO_MORE_FILES dikembalikan.

Persyaratan

Jenis persyaratan Persyaratan
Klien minimum yang didukung Pembaruan Windows 8.1
Header Ntifs.h (termasuk Ntifs.h atau Fltkernel.h)

Lihat juga

FltFsControlFile

ZwFsControlFile

FSCTL_GET_EXTERNAL_BACKING