структура 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, если канал подключен к каналу, считывается в или записывается из, операция не завершается до тех пор, пока не будут считаны данные, не будут записаны все данные или клиент не подключен.

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

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Верхняя часть ntifs.h (включая FltKernel.h, Ntifs.h)