На главную

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 | Скачать Вниз

WaitNamedPipe



The WaitNamedPipe function waits until either a time-out interval elapses or an instance of the specified named pipe is available to be connected to (that is, the pipe's server process has a pending ConnectNamedPipe operation on the pipe).

BOOL WaitNamedPipe(

LPCTSTR lpNamedPipeName, // address of name of pipe to wait for
DWORD nTimeOut // time-out interval, in milliseconds
);


Parameters

lpNamedPipeName

Points to a null-terminated string that specifies the name of the named pipe. The string must include the name of the computer on which the server process is executing. A period may be used for the servername if the pipe is local. The following pipe name format is used:



\\servername\pipe\pipename

nTimeOut

Specifies the number of milliseconds that the function will wait for an instance of the named pipe to be available. One of the following values can be used instead of specifying a number of milliseconds:

Value Meaning
NMPWAIT_USE_DEFAULT_WAIT The time-out interval is the default value specified by the server process in the CreateNamedPipe function.
NMPWAIT_WAIT_FOREVER The function does not return until an instance of the named pipe is available.


Return Values

If an instance of the pipe is available before the time-out interval elapses, the return value is nonzero.
If an instance of the pipe is not available before the time-out interval elapses, the return value is zero. To get extended error information, call GetLastError.

Remarks

If no instances of the specified named pipe exist, the WaitNamedPipe function returns immediately, regardless of the time-out value.
If the function succeeds, the process should use the CreateFile function to open a handle to the named pipe. A return value of TRUE indicates that there is at least one instance of the pipe available. A subsequent CreateFile call to the pipe can fail, because the instance was closed by the server or opened by another client.

See Also

CallNamedPipe, ConnectNamedPipe, CreateFile, CreateNamedPipe


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

WaitNamedPipe



Функция WaitNamedPipe ожидается до или интервал задержки истекает или пример определенной поименованной трубы доступен быть связанн, чтобы (то есть, процесс сервера трубы имеет незаконченную операцию ConnectNamedPipe в трубе).

BOOL WaitNamedPipe(

LPCTSTR lpNamedPipeName, // АДРЕС имени трубы, чтобы ждать DWORD nTimeOut // задерживать интервал, в течение миллисекунд
);


Параметры

lpNamedPipeName

Точки на недействительный расторгнутую строку, которые определяют имя поименованной трубы. Строка должна включить имя компьютера на котором процесс сервера выполняется. Период может быть использован для servername если труба локальная. Формат имени следующей трубы использован:



\\servername\pipe\pipename

nTimeOut

Определяет количество миллисекунд, что функция подождет пример поименованной трубы, чтобы быть доступно. Одно из следующего оценивает может быть использовано вместо определяющего множества миллисекунд:

Значение Величины
NMPWAIT_USE_DEFAULT_WAIT интервал задержки является значением по умолчанию определенным процессом сервера в функции CreateNamedPipe.
NMPWAIT_WAIT_FOREVER функция не возвращается пока пример поименованной трубы не будет доступен.


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

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

Замечания

Если никакие примеры определенной поименованной трубы не существуют, функциональный возврат WaitNamedPipe немедленно, независимо от величины задержки.
Если функция добивается успеха, процесс должен использовать функцию CreateFile, чтобы открывать ручку в поименованную трубу. Обратная величина ИСТИНЫ указывает, что есть по крайней мере один пример трубы доступной. Последующий вызов CreateFile в трубу может потерпеть неудачу, поскольку пример близко сервер или открытый другим клиентом.

Смотри Также

CallNamedPipe, ConnectNamedPipe, CreateFile, CreateNamedPipe


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