struktur NETWORK_OPEN_ECP_CONTEXT (ntifs.h)

Artikel
08/07/2023

Struktur NETWORK_OPEN_ECP_CONTEXT digunakan untuk menginterpretasikan konteks parameter pembuatan ekstra jaringan (ECP) pada file.

Sintaks

typedef struct _NETWORK_OPEN_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_IN_FLAGS            Flags;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_OUT_FLAGS           Flags;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT, *PNETWORK_OPEN_ECP_CONTEXT;

Anggota

Size

Ukuran, dalam byte, dari struktur ini.

Reserved

Dicadangkan. Harus diatur ke nol.

DUMMYSTRUCTNAME

Struktur yang berisi batasan yang akan diterapkan untuk membuka file (pra-buat) dan untuk diterapkan ke file setelah dibuka (pasca-buat).

DUMMYSTRUCTNAME.in

Struktur yang berisi pembatasan pra-buat untuk membuka file.

DUMMYSTRUCTNAME.in.Location

Nilai NETWORK_OPEN_LOCATION_QUALIFIER-typed yang menentukan batasan lokasi untuk dilampirkan ke file.

DUMMYSTRUCTNAME.in.Integrity

Nilai jenis NETWORK_OPEN_INTEGRITY_QUALIFIER yang menentukan pembatasan integritas untuk dilampirkan ke file.

DUMMYSTRUCTNAME.in.Flags

Didukung dimulai dengan Windows 7. Nilai yang menentukan atribut untuk file. Anggota ini adalah bitwise ATAU dari salah satu bendera berikut.

Nilai	Makna
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Menunjukkan kepada pengalih SMB bahwa permintaan terbuka yang masuk tidak boleh di-piggyback dan diciutkan ke handel terbuka yang ada ke file yang sama.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Menyebabkan pengalih SMB2+ menonaktifkan durabilitas pada handel terbuka ini. Untuk informasi selengkapnya tentang membuka file untuk operasi yang tahan lama, lihat Permintaan Aplikasi Membuat File yang Dibuka untuk Operasi Tahan Lama.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Menunjukkan kepada pengalih SMB untuk tidak memberikan oplock untuk permintaan terbuka yang masuk. Bendera ini tersedia dimulai dengan Windows 8.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Dicadangkan untuk penggunaan internal dan tidak boleh digunakan oleh aplikasi. Bendera ini memaksa pengalih untuk menggunakan I/O sinkron meskipun handel dibuka untuk I/O asinkron.

DUMMYSTRUCTNAME.out

Struktur yang berisi pembatasan pasca-buat untuk diterapkan ke file setelah dibuka.

DUMMYSTRUCTNAME.out.Location

Nilai NETWORK_OPEN_LOCATION_QUALIFIER-typed yang menentukan batasan lokasi untuk dilampirkan ke file.

DUMMYSTRUCTNAME.out.Integrity

Nilai jenis NETWORK_OPEN_INTEGRITY_QUALIFIER yang menentukan pembatasan integritas untuk dilampirkan ke file.

DUMMYSTRUCTNAME.out.Flags

Didukung dimulai dengan Windows 7. Nilai yang menentukan atribut untuk file. Anggota ini adalah bitwise ATAU dari salah satu bendera berikut.

Nilai	Makna
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Menunjukkan kepada pengalih SMB bahwa permintaan terbuka yang masuk tidak boleh di-piggyback dan diciutkan ke handel terbuka yang ada ke file yang sama.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Menyebabkan pengalih SMB2+ menonaktifkan durabilitas pada handel terbuka ini. Untuk informasi selengkapnya tentang membuka file untuk operasi yang tahan lama, lihat Permintaan Aplikasi Membuat File yang Dibuka untuk Operasi Tahan Lama.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Dicadangkan untuk penggunaan internal dan tidak boleh digunakan oleh aplikasi. Bendera ini memaksa pengalih untuk menggunakan I/O sinkron meskipun handel dibuka untuk I/O asinkron.

Keterangan

Untuk informasi tentang cara menggunakan ECP untuk mengaitkan informasi tambahan dengan file saat file dibuat, lihat Menggunakan Parameter Buat Ekstra dengan Operasi IRP_MJ_CREATE.

Driver filter harus mempertimbangkan struktur NETWORK_OPEN_ECP_CONTEXT bersifat baca-saja, menggunakannya hanya untuk mengambil informasi tentang konteks ECP jaringan pada file. Untuk informasi selengkapnya, lihat ECP yang Ditentukan Sistem.

Jika penelepon harus memverifikasi bahwa sistem file mengakui struktur konteks NETWORK_OPEN_ECP_CONTEXT , pemanggil harus memanggil rutinitas FltIsEcpAcknowledged atau FsRtlIsEcpAcknowledged pada ECP setelah operasi selesai.

Driver yang berjalan pada Windows 7 dan versi Windows yang lebih baru dan yang harus menafsirkan konteks ECP jaringan pada file yang berada di Windows Vista harus menggunakan struktur NETWORK_OPEN_ECP_CONTEXT_V0 sebagai gantinya.

Driver yang berjalan pada Windows Vista dan versi Windows yang lebih baru menggunakan struktur NETWORK_OPEN_ECP_CONTEXT untuk menginterpretasikan konteks ECP jaringan pada file. Namun, anggota DUMMYSTRUCTNAME.in.Flags dan DUMMYSTRUCTNAME.out.Flags hanya didukung dimulai dengan Windows 7.