Freigeben über

FILE_PIPE_INFORMATION Struktur (ntifs.h)

  • Artikel

Die FILE_PIPE_INFORMATION-Struktur enthält Informationen zu einem benannten Rohr, das nicht für das lokale oder das Remoteende der Rohre spezifisch ist.

Syntax

typedef struct _FILE_PIPE_INFORMATION {
  ULONG ReadMode;
  ULONG CompletionMode;
} FILE_PIPE_INFORMATION, *PFILE_PIPE_INFORMATION;

Angehörige

ReadMode

Einer der folgenden Werte.

Wert Bedeutung
FILE_PIPE_BYTE_STREAM_MODE (0x00000000) Daten werden aus der Pipe als Bytestrom gelesen.
FILE_PIPE_MESSAGE_MODE (0x00000001) Daten werden aus der Pipe als Datenstrom von Nachrichten gelesen.

CompletionMode

Einer der folgenden Werte.

Wert Bedeutung
FILE_PIPE_QUEUE_OPERATION (0x00000000) Blockierungsmodus
FILE_PIPE_COMPLETE_OPERATION (0x00000001) Nicht blockierenden Modus

Bemerkungen

Wenn ReadMode- auf FILE_PIPE_BYTE_STREAM_MODE festgelegt ist, muss jeder Versuch, ihn zu ändern, mit einem STATUS_INVALID_PARAMETER Fehlercode fehlschlagen.

Wenn CompletionMode- auf FILE_PIPE_QUEUE_OPERATION festgelegt ist, wird der Vorgang erst abgeschlossen, wenn die Pipe mit der Pipe verbunden, gelesen oder geschrieben wird, erst abgeschlossen, wenn Daten gelesen werden sollen, alle Daten geschrieben oder ein Client verbunden ist.

Hinweis Ein Wert von FILE_PIPE_QUEUE_OPERATION für CompletionMode- kann dazu führen, dass ein Clientprozess auf unbestimmte Zeit wartet, um eine Aktion auszuführen.
 
Wenn CompletionMode- auf FILE_PIPE_COMPLETE_OPERATION festgelegt ist, wird der Vorgang sofort abgeschlossen, wenn die Pipe mit der Verbindung, dem Lesen oder Schreiben aus verbunden ist.

Informationen zu Rohren finden Sie unter Pipes.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000
Header- ntifs.h (include FltKernel.h, Ntifs.h)