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值可能会导致客户端进程无限期地等待执行作。
有关管道的信息,请参阅 管道。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 |
标头 | ntifs.h (包括 FltKernel.h、Ntifs.h) |