На главную

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

DisconnectNamedPipe



The DisconnectNamedPipe function disconnects the server end of a named pipe instance from a client process.

BOOL DisconnectNamedPipe(

HANDLE hNamedPipe // handle to named pipe
);


Parameters

hNamedPipe

Identifies an instance of a named pipe. This handle must be created by the CreateNamedPipe function.



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.

Remarks

If the client end of the named pipe is open, the DisconnectNamedPipe function forces that end of the named pipe closed. The client receives an error the next time it attempts to access the pipe. A client that is forced off a pipe by DisconnectNamedPipe must still use the CloseHandle function to close its end of the pipe.
When the server process disconnects a pipe instance, any unread data in the pipe is discarded. Before disconnecting, the server can make sure data is not lost by calling the FlushFileBuffers function, which does not return until the client process has read all the data.

The server process must call DisconnectNamedPipe to disconnect a pipe handle from its previous client before the handle can be connected to another client by using the ConnectNamedPipe function.

See Also

CloseHandle, ConnectNamedPipe, CreateNamedPipe, FlushFileBuffers


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

DisconnectNamedPipe



Функция DisconnectNamedPipe отключает конец сервера поименованного примера трубы от процесса клиента.

BOOL DisconnectNamedPipe(

РУЧКА РУЧКИ hNamedPipe // на называла трубу
);


Параметры

hNamedPipe

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



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

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

Замечания

Если конец клиента поименованной трубы открытый, функциональные силы DisconnectNamedPipe, что конец поименованной трубы закрывал. Клиент получает ошибку следующий раз это пытается иметь доступ к трубе. Клиент, который усилен труба DisconnectNamedPipe должна все еще использовать функцию CloseHandle, чтобы закрывать свой конец трубы.
Когда процесс сервера разъединяет пример трубы, любые unread данные в трубе отвергнуты. Перед отключением, сервер может убедиться что данные не потерены вызовом функции FlushFileBuffers, какое не возвращает пока процесс клиента не прочитал все данные.

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

Смотри Также

CloseHandle, ConnectNamedPipe, CreateNamedPipe, FlushFileBuffers


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