Bagikan melalui


struktur NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

Struktur NETWORK_APP_INSTANCE_ECP_CONTEXT adalah Extra Create Parameter (ECP) dan berisi pengidentifikasi instans aplikasi untuk dikaitkan dengan file. Struktur ini digunakan untuk mengidentifikasi file yang dibuka untuk aplikasi klien kluster failover ketika aplikasi tersebut melanjutkan akses ke filenya pada simpul lain.

Sintaks

typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  GUID   AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;

Anggota

Size

Ukuran struktur ini. Anggota ini diatur ke sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).

Reserved

Dicadangkan. Harus diatur ke nol.

AppInstanceID

Pengidentifikasi instans unik untuk aplikasi klien kluster failover. Ini adalah GUID yang mengaitkan aplikasi ke file yang dibuka pada node kluster failover.

Keterangan

Ketika failover ke node sekunder dalam kluster server terjadi, aplikasi klien kluster memerlukan akses dilanjutkan ke file yang pertama kali dibuka pada node yang gagal. Infrastruktur Failover Klien Kluster mencegah pelanggaran berbagi untuk file aplikasi pada simpul failover dengan memvalidasi aksesnya ke file-file tersebut. Akses diberikan ke file pada simpul failover yang memiliki pengidentifikasi instans aplikasi yang sama dengan file yang dibuka pada simpul lain sebelum failover. Pengidentifikasi instans ditemukan dalam struktur NETWORK_APP_INSTANCE_ECP_CONTEXT dalam daftar ECP file.

Misalnya, driver filter sistem file akan mengalokasikan NETWORK_APP_INSTANCE_ECP_CONTEXT dengan GUID instans aplikasi unik. Struktur konteks dimasukkan ke dalam daftar ECP file saat dibuat atau dibuka. Node kluster menyimpan cache pengidentifikasi instans dari ECP saat memproses permintaan pembuatan sistem file jaringan. Pada failover, simpul melanjutkan dapat mencocokkan aplikasi dengan kumpulan file yang dibuka dan memberikan akses.

NETWORK_APP_INSTANCE_ECP_CONTEXT diidentifikasi dalam ECP_LIST oleh GUID_ECP_NETWORK_APP_INSTANCE. Ini dan pengidentifikasi lain yang ditentukan sistem dijelaskan dalam ECP yang Ditentukan Sistem.

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.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Struktur ini Windows 8
Header ntifs.h (termasuk Ntifs.h)

Lihat juga

ECP_LIST

IoCreateFileEx