Freigeben über

FILE_PIPE_LOCAL_INFORMATION Struktur (ntifs.h)

  • Artikel

Die FILE_PIPE_LOCAL_INFORMATION-Struktur enthält Informationen zum lokalen Ende einer benannten Pfeife.

Syntax

typedef struct _FILE_PIPE_LOCAL_INFORMATION {
  ULONG NamedPipeType;
  ULONG NamedPipeConfiguration;
  ULONG MaximumInstances;
  ULONG CurrentInstances;
  ULONG InboundQuota;
  ULONG ReadDataAvailable;
  ULONG OutboundQuota;
  ULONG WriteQuotaAvailable;
  ULONG NamedPipeState;
  ULONG NamedPipeEnd;
} FILE_PIPE_LOCAL_INFORMATION, *PFILE_PIPE_LOCAL_INFORMATION;

Angehörige

NamedPipeType

Einer der folgenden benannten Rohrtypen.

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

NamedPipeConfiguration

Eine der folgenden benannten Pipekonfigurationen.

Wert Bedeutung
FILE_PIPE_INBOUND (0x00000000) Der Datenfluss in der Pipe geht nur von Client zu Server.
FILE_PIPE_OUTBOUND (0x00000001) Der Datenfluss in der Pipe geht nur vom Server zum Client.
FILE_PIPE_FULL_DUPLEX (0x00000002) Das Rohr ist bidirektional; Sowohl Server- als auch Clientprozesse können aus der Pipe gelesen und in die Pipeline geschrieben werden.

MaximumInstances

Die maximale Anzahl von Instanzen, die für diese Pipe erstellt werden können. Die erste Instanz der Pipe muss diesen Wert angeben.

CurrentInstances

Die Anzahl der aktuellen benannten Pipeinstanzen.

InboundQuota

Das eingehende Kontingent in Byte für die benannte Pipe.

ReadDataAvailable

Die Menge der verfügbaren Daten in Bytes, die aus der benannten Pipe gelesen werden sollen.

OutboundQuota

Das ausgehende Kontingent in Bytes für die benannte Pipe.

WriteQuotaAvailable

Das Schreibkontingent in Byte für die benannte Pipe.

NamedPipeState

Der Verbindungsstatus für die benannte Pipe. Dieser Zustand weist einen der folgenden Werte auf.

Wert Bedeutung
FILE_PIPE_DISCONNECTED_STATE (0x00000001) Benannte Rohre werden getrennt.
FILE_PIPE_LISTENING_STATE (0x00000002) Benannte Pipe wartet darauf, eine Verbindung herzustellen.
FILE_PIPE_CONNECTED_STATE (0x00000003) Benanntes Rohr ist verbunden.
FILE_PIPE_CLOSING_STATE (0x00000004) Benanntes Rohr wird geschlossen.

NamedPipeEnd

Der Typ des benannten Pipe-Endes, der angibt, ob es sich um den Client oder die Serverseite einer benannten Pipe handelt.

Wert Bedeutung
FILE_PIPE_CLIENT_END (0x00000000) Dies ist das Clientende einer benannten Pipe.
FILE_PIPE_SERVER_END (0x00000001) Dies ist das Serverende einer benannten Pipe.

Bemerkungen

Informationen zu Rohren finden Sie unter Pipes.

Anforderungen

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