Поделиться через

структура 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.

Если CompleteMode установлено значение FILE_PIPE_QUEUE_OPERATION, если канал подключен к каналу, считывается или записывается из нее, операция не завершается до тех пор, пока данные не будут считываться, все данные записываются или клиент подключен.

Примечание Значение FILE_PIPE_QUEUE_OPERATION для CompletionMode может привести к ожиданию неограниченного срока выполнения клиентского процесса.
 
Если CompleteMode установлено значение FILE_PIPE_COMPLETE_OPERATION, если канал подключен к каналу, считывается или записывается из нее, операция завершается немедленно.

Сведения о каналах см. в разделе Трубы.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
заголовка ntifs.h (include FltKernel.h, Ntifs.h)