FILE_PIPE_LOCAL_INFORMATION Struktur (ntifs.h)

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

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;

Member

NamedPipeType

Einer der folgenden Named Pipe-Typen.

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

NamedPipeConfiguration

Eine der folgenden Named Pipe-Konfigurationen.

Wert	Bedeutung
FILE_PIPE_INBOUND (0x00000000)	Der Datenfluss in der Pipe geht nur vom Client zum Server.
FILE_PIPE_OUTBOUND (0x00000001)	Der Datenfluss in der Pipe geht nur vom Server zum Client.
FILE_PIPE_FULL_DUPLEX (0x00000002)	Die Pipe ist bidirektional; Sowohl Server- als auch Clientprozesse können aus der Pipe lesen und in diese schreiben.

MaximumInstances

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

CurrentInstances

Die Anzahl der aktuellen Named Pipe-Instanzen.

InboundQuota

Das eingehende Kontingent in Bytes 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 Bytes für die benannte Pipe.

NamedPipeState

Die Verbindung status für die benannte Pipe. Dieser Zustand weist einen der folgenden Werte auf.

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

NamedPipeEnd

Der Typ des Named Pipe-Endes, der angibt, ob dies der Client oder die Serverseite einer benannten Pipe ist.

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

Hinweise

Informationen zu Pipes finden Sie unter Pipes.

Anforderungen

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