NETWORK_OPEN_ECP_CONTEXT-Struktur (ntifs.h)

Artikel
02/26/2024

Die NETWORK_OPEN_ECP_CONTEXT-Struktur wird verwendet, um ECP-Kontexte (Network Extra Create Parameter) für Dateien zu interpretieren.

Syntax

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;

Member

Size

Die Größe (in Bytes) dieser Struktur.

Reserved

Reserviert. Muss auf 0 festgelegt werden.

DUMMYSTRUCTNAME

Eine Struktur, die Einschränkungen für das Öffnen der Datei (Voraberstellung) und die Anwendung auf die Datei enthält, nachdem sie geöffnet wurde (nach der Erstellung).

DUMMYSTRUCTNAME.in

Struktur, die Voraberstellungseinschränkungen zum Öffnen einer Datei enthält.

DUMMYSTRUCTNAME.in.Location

Ein NETWORK_OPEN_LOCATION_QUALIFIER typisierter Wert, der die Speicherorteinschränkung angibt, die an die Datei angefügt werden soll.

DUMMYSTRUCTNAME.in.Integrity

Ein NETWORK_OPEN_INTEGRITY_QUALIFIER typisierter Wert, der die Integritätseinschränkung angibt, die an die Datei angefügt werden soll.

DUMMYSTRUCTNAME.in.Flags

Wird ab Windows 7 unterstützt. Ein Wert, der Attribute für die Datei angibt. Dieses Element ist ein bitweiser OR der folgenden Flags.

Wert	Bedeutung
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Gibt für den SMB-Redirector an, dass die eingehende offene Anforderung nicht verschweigt und auf ein vorhandenes geöffnetes Handle in derselben Datei reduziert werden darf.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Bewirkt, dass der SMB2+-Redirector die Dauerhaftigkeit für dieses geöffnete Handle deaktiviert. Weitere Informationen zum Öffnen einer Datei für dauerhaften Vorgang finden Sie unter Anwendungsanforderungen Erstellen einer geöffneten Datei für dauerhaften Vorgang.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Gibt an, dass der SMB-Redirector keine Oplocks für die eingehende offene Anforderung gewährt. Dieses Flag ist ab Windows 8 verfügbar.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reserviert für den internen Gebrauch und darf nicht von Anwendungen verwendet werden. Dieses Flag zwingt den Umleitungsor, synchrone E/A-Vorgänge zu verwenden, obwohl das Handle für asynchrone E/A geöffnet wurde.

DUMMYSTRUCTNAME.out

Struktur, die Einschränkungen nach der Erstellung enthält, die nach dem Öffnen auf eine Datei angewendet werden sollen.

DUMMYSTRUCTNAME.out.Location

Ein NETWORK_OPEN_LOCATION_QUALIFIER typisierter Wert, der die Speicherorteinschränkung angibt, die an die Datei angefügt werden soll.

DUMMYSTRUCTNAME.out.Integrity

Ein NETWORK_OPEN_INTEGRITY_QUALIFIER typisierter Wert, der die Integritätseinschränkung angibt, die an die Datei angefügt werden soll.

DUMMYSTRUCTNAME.out.Flags

Wird ab Windows 7 unterstützt. Ein Wert, der Attribute für die Datei angibt. Dieses Element ist ein bitweiser OR der folgenden Flags.

Wert	Bedeutung
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Gibt für den SMB-Redirector an, dass die eingehende offene Anforderung nicht verschweigt und auf ein vorhandenes geöffnetes Handle in derselben Datei reduziert werden darf.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Bewirkt, dass der SMB2+-Redirector die Dauerhaftigkeit für dieses geöffnete Handle deaktiviert. Weitere Informationen zum Öffnen einer Datei für dauerhaften Vorgang finden Sie unter Anwendungsanforderungen Erstellen einer geöffneten Datei für dauerhaften Vorgang.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reserviert für den internen Gebrauch und darf nicht von Anwendungen verwendet werden. Dieses Flag zwingt den Umleitungsor, synchrone E/A-Vorgänge zu verwenden, obwohl das Handle für asynchrone E/A geöffnet wurde.

Hinweise

Informationen zur Verwendung von ECPs zum Zuordnen zusätzlicher Informationen zu einer Datei beim Erstellen der Datei finden Sie unter Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

Ein Filtertreiber sollte die NETWORK_OPEN_ECP_CONTEXT Struktur als schreibgeschützt betrachten, wobei sie nur zum Abrufen von Informationen zum Netzwerk-ECP-Kontext in einer Datei verwendet wird. Weitere Informationen finden Sie unter Systemdefinierte ECPs.

Wenn ein Aufrufer überprüfen muss, ob das Dateisystem die NETWORK_OPEN_ECP_CONTEXT Kontextstruktur bestätigt hat, sollte der Aufrufer die FltIsEcpAcknowledged - oder FsRtlIsEcpAcknowledged-Routine für den ECP aufrufen, nachdem der Vorgang abgeschlossen ist.

Treiber, die unter Windows 7 und höheren Versionen von Windows ausgeführt werden und netzwerkbezogene ECP-Kontexte für Dateien interpretieren müssen, die sich unter Windows Vista befinden, müssen stattdessen die NETWORK_OPEN_ECP_CONTEXT_V0-Struktur verwenden.

Treiber, die unter Windows Vista und höheren Versionen von Windows ausgeführt werden, verwenden die NETWORK_OPEN_ECP_CONTEXT-Struktur , um Netzwerk-ECP-Kontexte für Dateien zu interpretieren. Die Mitglieder DUMMYSTRUCTNAME.in.Flags und DUMMYSTRUCTNAME.out.Flags werden jedoch nur ab Windows 7 unterstützt.