struktur ECP_OPEN_PARAMETERS (ntifs.h)

  • Artikel

Struktur ECP_OPEN_PARAMETERS berisi konteks parameter buat ekstra (ECP) yang memungkinkan pemanggil untuk menentukan tujuan pembukaan file tanpa mengganggu handel yang ada dan/atau kunci oportunistik (oplock) pada file.

Sintaks

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

Anggota

Size

Menentukan ukuran struktur konteks ini, dalam byte.

Reserved

Disiapkan untuk penggunaan masa mendatang. Ini harus diinisialisasi ke 0.

Flags

Bendera yang menentukan parameter atau tujuan untuk membuka file. Bendera dapat berupa kombinasi apa pun dari nilai berikut:

Nilai Deskripsi
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) Membuka file untuk membacanya.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) Membuka file untuk menulis ke file tersebut.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) Membuka file untuk menghapusnya.
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) Memaksa pencarian yang tidak peka huruf besar/kecil untuk file ini terbuka, bahkan di bawah direktori peka huruf besar/kecil. Tersedia dimulai dengan Windows 10, versi 2004.
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR (0x0010) Gagal membuka file atau membuat permintaan jika jalur memiliki direktori sensitif huruf besar/kecil. Tersedia dimulai dengan Windows 10, versi 2004.

Keterangan

Bendera ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ dan ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE memungkinkan akses baca/tulis ke file terenkripsi tanpa harus benar-benar membuka file tersebut untuk akses baca/tulis. Bendera ECP ini memungkinkan komponen mode kernel terbuka untuk akses khusus metadata, sehingga tidak mengganggu akses lain sambil tetap mendapatkan pengaturan konteks enkripsi untuk melakukan baca/tulis. Filter dapat mengatur bendera ini untuk menghindari konflik dengan penguncian. Menyiapkan status enkripsi untuk operasi baca/tulis mahal dan biasanya tidak dilakukan ketika file tidak dibuka untuk akses baca/tulis.

Nilai GUID_ECP_OPEN_PARAMETERS yang ditentukan sistem digunakan dengan struktur konteks ECP ini saat memanggil rutinitas dukungan terkait ECP seperti FltAllocateExtraCreateParameter dan FsRtlRemoveExtraCreateParameter.

Lihat Pengantar parameter pembuatan tambahan untuk informasi selengkapnya.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1709.
Header ntifs.h (termasuk Ntifs.h)

Lihat juga

FltAllocateExtraCreateParameterList

FltCreateFileEx2