На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetNamedPipeInfo



The GetNamedPipeInfo function retrieves information about the specified named pipe.

BOOL GetNamedPipeInfo(

HANDLE hNamedPipe, // handle of named pipe
LPDWORD lpFlags, // address of flags indicating type of pipe
LPDWORD lpOutBufferSize, // address of size, in bytes, of pipe's output buffer
LPDWORD lpInBufferSize, // address of size, in bytes, of pipe's input buffer
LPDWORD lpMaxInstances // address of max. number of pipe instances
);


Parameters

hNamedPipe

Identifies the named pipe instance. The handle must have GENERIC_READ access to the named pipe.

lpFlags

Points to a 32-bit variable that indicates the type of the named pipe. This parameter can be NULL if this information is not required. Otherwise, use the following values:

Value Meaning
PIPE_CLIENT_END The handle refers to the client end of a named pipe instance. This is the default.
PIPE_SERVER_END The handle refers to the server end of a named pipe instance. If this value is not specified, the handle refers to the client end of a named pipe instance.
PIPE_TYPE_BYTE The named pipe is a byte pipe. This is the default.
PIPE_TYPE_MESSAGE The named pipe is a message pipe. If this value is not specified, the pipe is a byte pipe.


lpOutBufferSize

Points to a 32-bit variable that receives the size, in bytes, of the buffer for outgoing data. If the buffer size is zero, the buffer is allocated as needed. This parameter can be NULL if this information is not required.

lpInBufferSize

Points to a 32-bit variable that receives the size, in bytes, of the buffer for incoming data. If the buffer size is zero, the buffer is allocated as needed. This parameter can be NULL if this information is not required.

lpMaxInstances

Points to a 32-bit variable that receives the maximum number of pipe instances that can be created. If the variable is set to PIPE_UNLIMITED_INSTANCES, the number of pipe instances that can be created is limited only by the availability of system resources. This parameter can be NULL if this information is not required.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

See Also

CreateNamedPipe, GetNamedPipeHandleState


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetNamedPipeInfo



Функция GetNamedPipeInfo извлекает информацию об определенной поименованной трубе.

BOOL GetNamedPipeInfo(

РУЧКА hNamedPipe, // ручка поименованной трубы LPDWORD lpFlags, // адреса флагов, указывающие тип трубы LPDWORD lpOutBufferSize, // адреса размера, в байтах, выходного буфера трубы LPDWORD lpInBufferSize, // адрес размера, в байтах, входного буфера адреса трубы LPDWORD lpMaxInstances // max. номера примеров трубы
);


Параметры

hNamedPipe

Идентифицирует поименованный пример трубы. Ручка должна иметь доступ GENERIC_READ к поименованной трубе.

lpFlags

Точки на 32- битовую переменную, которые указывают тип поименованной трубы. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если эта информация не потребовалась. В противном случае, использовать следующее величин:

Значение Величины
PIPE_CLIENT_END ручка имеет отношение к концу клиента поименованного примера трубы. Это по умолчанию.
PIPE_SERVER_END ручка имеет отношение к концу сервера поименованного примера трубы. Если эта величина не определена, ручка имеет отношение к концу клиента поименованного примера трубы.
PIPE_TYPE_BYTE поименованная труба является байтовой трубой. Это по умолчанию.
PIPE_TYPE_MESSAGE поименованная труба является трубой сообщения. Если эта величина не определена, труба является байтовой трубой.


lpOutBufferSize

Точки на 32- битовую переменную, которые получают размер, в байтах, буфера для исходящих данных. Если буферный размер является нулем, буфер распределяется как и требуется. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если эта информация не потребовалась.

lpInBufferSize

Точки на 32- битовую переменную, которые получают размер, в байтах, буфера для поступающих данных. Если буферный размер является нулем, буфер распределяется как и требуется. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если эта информация не потребовалась.

lpMaxInstances

Точки на 32- битовую переменную, которые получают максимальный номер примеров трубы, которая может быть создана. Если переменная установлена на PIPE_UNLIMITED_INSTANCES, номер примеров трубы, которая может быть создана, ограниченн только доступностью системных ресурсов. Этот параметр может быть НЕДЕЙСТВИТЕЛЕН если эта информация не потребовалась.



Обратные Величины

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

Смотри Также

CreateNamedPipe, GetNamedPipeHandleState


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz