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)