Freigeben über

FILE_PIPE_INFORMATION-Struktur (ntifs.h)

  • Artikel

Die FILE_PIPE_INFORMATION-Struktur enthält Informationen zu einer Benannten Pipe, die nicht spezifisch für das lokale oder remote Ende der Pipe ist.

Syntax

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

Member

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 Nachrichtenstrom gelesen.

CompletionMode

Einer der folgenden Werte.

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

Hinweise

Wenn ReadMode auf FILE_PIPE_BYTE_STREAM_MODE festgelegt ist, muss jeder Änderungsversuch mit einem STATUS_INVALID_PARAMETER Fehlercode fehlschlagen.

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

Hinweis Der Wert FILE_PIPE_QUEUE_OPERATION für CompletionMode kann dazu führen, dass unbegrenzt gewartet wird, bis ein Clientprozess eine Aktion ausführt.
 
Wenn CompletionMode auf FILE_PIPE_COMPLETE_OPERATION festgelegt ist, wird der Vorgang sofort abgeschlossen, wenn die Pipe mit verbunden, in gelesen oder aus geschrieben wird.

Informationen zu Pipes finden Sie unter Pipes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Kopfzeile ntifs.h (include FltKernel.h, Ntifs.h)