FILE_PIPE_INFORMATION结构 (ntifs.h)

FILE_PIPE_INFORMATION 结构包含有关不特定于管道本地或远程端的命名管道的信息。

语法

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

成员

ReadMode

以下值之一。

价值 意义
FILE_PIPE_BYTE_STREAM_MODE(0x00000000) 数据作为字节流从管道中读取。
FILE_PIPE_MESSAGE_MODE(0x00000001) 数据作为消息流从管道中读取。

CompletionMode

以下值之一。

价值 意义
FILE_PIPE_QUEUE_OPERATION(0x00000000) 阻止模式
FILE_PIPE_COMPLETE_OPERATION (0x00000001) 非阻止模式

言论

如果 ReadMode 设置为FILE_PIPE_BYTE_STREAM_MODE,则任何尝试更改它都必须失败并出现STATUS_INVALID_PARAMETER错误代码。

CompletionMode 设置为FILE_PIPE_QUEUE_OPERATION时,如果管道连接到、读取或写入作,则在有要读取的数据、写入所有数据或客户端连接之前,不会完成该作。

注释CompletionMode 的FILE_PIPE_QUEUE_OPERATION值可能会导致客户端进程无限期地等待执行作。
 
CompletionMode 设置为FILE_PIPE_COMPLETE_OPERATION时,如果管道连接到、读取或写入管道,则作将立即完成。

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

要求

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