NETWORK_OPEN_ECP_CONTEXT-Struktur (ntifs.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Diese Struktur ist ab Windows Vista verfügbar. |
Kopfzeile | ntifs.h (include Ntifs.h) |