NETWORK_OPEN_ECP_CONTEXT Struktur (ntifs.h)

Artikel
12/21/2024

Die NETWORK_OPEN_ECP_CONTEXT-Struktur wird verwendet, um zusätzliche Netzwerkerstellungsparameterkontexte (ECP) 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;

Angehörige

Size

Die Größe dieser Struktur in Byte.

Reserved

Reserviert. Muss auf Null festgelegt werden.

DUMMYSTRUCTNAME

Eine Struktur, die Einschränkungen enthält, die zum Öffnen der Datei (vorab erstellt) und nach dem Öffnen (nach dem Erstellen) auf die Datei angewendet werden sollen.

DUMMYSTRUCTNAME.in

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

DUMMYSTRUCTNAME.in.Location

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

DUMMYSTRUCTNAME.in.Integrity

Ein NETWORK_OPEN_INTEGRITY_QUALIFIER-typed-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 bitweises ODER eines der folgenden Flags.

Wert	Bedeutung
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Gibt an, dass der SMB-Redirector, dass die eingehende geöffnete Anforderung nicht geschweigeigt und auf ein vorhandenes geöffnetes Handle für dieselbe Datei reduziert werden darf.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Bewirkt, dass der SMB2+-Redirector die Haltbarkeit für diesen offenen Handle deaktiviert. Weitere Informationen zum Öffnen einer Datei für dauerhaften Vorgang finden Sie unter Anwendungsanforderungen Erstellen einer Datei, die für dauerhaften Vorgang geöffnet.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Gibt an, dass der SMB-Redirector oplocks für die eingehende offene Anforderung nicht gewährt. Dieses Kennzeichen ist ab Windows 8 verfügbar.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reserviert für die interne Verwendung und darf nicht von Anwendungen verwendet werden. Mit dieser Kennzeichnung wird der Umleitungsmodul gezwungen, synchrone E/A zu verwenden, obwohl der Handle für asynchrone E/A geöffnet wurde.

DUMMYSTRUCTNAME.out

Struktur, die nach dem Erstellen von Einschränkungen enthält, die auf eine Datei angewendet werden sollen, nachdem sie geöffnet wurde.

DUMMYSTRUCTNAME.out.Location

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

DUMMYSTRUCTNAME.out.Integrity

Ein NETWORK_OPEN_INTEGRITY_QUALIFIER-typed-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 bitweises ODER eines der folgenden Flags.

Wert	Bedeutung
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Gibt an, dass der SMB-Redirector, dass die eingehende geöffnete Anforderung nicht geschweigeigt und auf ein vorhandenes geöffnetes Handle für dieselbe Datei reduziert werden darf.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Bewirkt, dass der SMB2+-Redirector die Haltbarkeit für diesen offenen Handle deaktiviert. Weitere Informationen zum Öffnen einer Datei für dauerhaften Vorgang finden Sie unter Anwendungsanforderungen Erstellen einer Datei, die für dauerhaften Vorgang geöffnet.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Reserviert für die interne Verwendung und darf nicht von Anwendungen verwendet werden. Mit dieser Kennzeichnung wird der Umleitungsmodul gezwungen, synchrone E/A zu verwenden, obwohl der Handle für asynchrone E/A geöffnet wurde.

Bemerkungen

Informationen zur Verwendung von ECPs zum Zuordnen zusätzlicher Informationen zu einer Datei beim Erstellen der Datei finden Sie unter Verwenden von zusätzlichen Erstellungsparametern mit einem IRP_MJ_CREATE Operation.

Ein Filtertreiber sollte die NETWORK_OPEN_ECP_CONTEXT Struktur als schreibgeschützt betrachten, indem er nur Informationen zum Netzwerk-ECP-Kontext in einer Datei abruft. Weitere Informationen finden Sie unter System-Defined ECPs.

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

Treiber, die unter Windows 7 und höheren Versionen von Windows ausgeführt werden und Netzwerk-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 DUMMYSTRUCTNAME.in.Flags und DUMMYSTRUCTNAME.out.Flags Member werden jedoch erst ab Windows 7 unterstützt.