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

структура FILE_PIPE_LOCAL_INFORMATION (ntifs.h)

  • Статья

Структура FILE_PIPE_LOCAL_INFORMATION содержит сведения о локальном конце именованного канала.

Синтаксис

typedef struct _FILE_PIPE_LOCAL_INFORMATION {
  ULONG NamedPipeType;
  ULONG NamedPipeConfiguration;
  ULONG MaximumInstances;
  ULONG CurrentInstances;
  ULONG InboundQuota;
  ULONG ReadDataAvailable;
  ULONG OutboundQuota;
  ULONG WriteQuotaAvailable;
  ULONG NamedPipeState;
  ULONG NamedPipeEnd;
} FILE_PIPE_LOCAL_INFORMATION, *PFILE_PIPE_LOCAL_INFORMATION;

Члены

NamedPipeType

Один из следующих именованных типов каналов.

Ценность Значение
FILE_PIPE_BYTE_STREAM_TYPE (0x00000000) Данные считываются из канала в виде потока байтов.
FILE_PIPE_MESSAGE_TYPE (0x00000001) Данные считываются из канала в виде потока сообщений.

NamedPipeConfiguration

Одна из следующих конфигураций именованных каналов.

Ценность Значение
FILE_PIPE_INBOUND (0x00000000) Поток данных в канале передается только от клиента к серверу.
FILE_PIPE_OUTBOUND (0x00000001) Поток данных в канале передается только с сервера на клиент.
FILE_PIPE_FULL_DUPLEX (0x00000002) Канал двунаправленный; как серверные, так и клиентские процессы могут считывать и записывать данные в канал.

MaximumInstances

Максимальное количество экземпляров, которые можно создать для этого канала. Первый экземпляр канала должен указать это значение.

CurrentInstances

Количество текущих экземпляров именованных каналов.

InboundQuota

Квота для входящего трафика в байтах для именованного канала.

ReadDataAvailable

Объем данных, доступных в байтах, считываемых из именованного канала.

OutboundQuota

Квота исходящего трафика в байтах для именованного канала.

WriteQuotaAvailable

Квота записи (в байтах) для именованного канала.

NamedPipeState

Состояние подключения для именованного канала. Это состояние имеет одно из следующих значений.

Ценность Значение
FILE_PIPE_DISCONNECTED_STATE (0x00000001) Именованный канал отключен.
FILE_PIPE_LISTENING_STATE (0x00000002) Именованный канал ожидает установления подключения.
FILE_PIPE_CONNECTED_STATE (0x00000003) Именованный канал подключен.
FILE_PIPE_CLOSING_STATE (0x00000004) Именованный канал находится в процессе закрытия.

NamedPipeEnd

Тип именованного конца канала, который указывает, является ли клиент или стороной сервера именованного канала.

Ценность Значение
FILE_PIPE_CLIENT_END (0x00000000) Это конец клиента именованного канала.
FILE_PIPE_SERVER_END (0x00000001) Это конец сервера именованного канала.

Замечания

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

Требования

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