FILE_PIPE_LOCAL_INFORMATION 结构 (ntifs.h)

FILE_PIPE_LOCAL_INFORMATION 结构包含有关命名管道的本地端的信息。

语法

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;

成员

NamedPipeType

以下命名管道类型之一。

含义
FILE_PIPE_BYTE_STREAM_TYPE (0x00000000) 数据作为字节流从管道中读取。
FILE_PIPE_MESSAGE_TYPE (0x00000001) 数据作为消息流从管道中读取。

NamedPipeConfiguration

以下命名管道配置之一。

含义
FILE_PIPE_INBOUND (0x00000000) 管道中的数据流仅从客户端流向服务器。
FILE_PIPE_OUTBOUND (0x00000001) 管道中的数据流仅从服务器流向客户端。
FILE_PIPE_FULL_DUPLEX (0x00000002) 管道是双向的;服务器和客户端进程都可以从管道读取和写入管道。

MaximumInstances

可为此管道创建的最大实例数。 管道的第一个实例必须指定此值。

CurrentInstances

当前命名管道实例的数目。

InboundQuota

命名管道的入站配额(以字节为单位)。

ReadDataAvailable

要从命名管道读取的可用数据量(以字节为单位)。

OutboundQuota

命名管道的出站配额(以字节为单位)。

WriteQuotaAvailable

命名管道的写入配额(以字节为单位)。

NamedPipeState

命名管道的连接状态。 此状态具有以下值之一。

含义
FILE_PIPE_DISCONNECTED_STATE (0x00000001) 命名管道已断开连接。
FILE_PIPE_LISTENING_STATE (0x00000002) 命名管道正在等待建立连接。
FILE_PIPE_CONNECTED_STATE (0x00000003) 已连接命名管道。
FILE_PIPE_CLOSING_STATE (0x00000004) 命名管道正在关闭。

NamedPipeEnd

命名管道端的类型,指定这是命名管道的客户端还是服务器端。

含义
FILE_PIPE_CLIENT_END (0x00000000) 这是命名管道的客户端端。
FILE_PIPE_SERVER_END (0x00000001) 这是命名管道的服务器端。

注解

有关管道的信息,请参阅 管道

要求

要求
最低受支持的客户端 Windows 2000
标头 ntifs.h (包括 FltKernel.h、Ntifs.h)