Структура FILE_PIPE_INFORMATION (нтифс. 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) Режим без блокировки

Remarks

Если ReadMode имеет значение FILE_PIPE_BYTE_STREAM_MODE, то любая попытка его изменить должна завершиться с STATUS_INVALID_PARAMETER кодом ошибки.

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

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

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

Требования

   
Минимальная версия клиента доступно в Windows 2000 и более поздних версиях операционной системы Windows.
Header нтифс. h (включая Флткернел. h, Нтифс. h)