На главную

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

RasHangUp



The RasHangUp function terminates a remote access connection. The connection is specified with a RAS connection handle. The function releases all RASAPI32.DLL resources associated with the handle.

DWORD RasHangUp(

HRASCONN hrasconn // handle to the RAS connection to hang up
);


Parameters

hrasconn

Identifies the remote access connection to terminate. This is a handle returned from a previous call to RasDial or RasEnumConnections.



Return Values

If the function succeeds, the return value is zero.
If the function fails, the return value is a nonzero error value listed in the RAS header file, or ERROR_INVALID_HANDLE.

Remarks

The connection is terminated even if the RasDial call has not yet been completed.
After this call, the hrasconn handle can no longer be used.
An application should not call RasHangUp and then immediately exit. The connection state machine needs time to properly terminate. If the system prematurely terminates the state machine, the state machine may fail to properly close a port, leaving the port in an inconsistent state. A simple way to avoid this problem is to call Sleep(3000) after returning from RasHangUp; after that pause, the application can exit. A more responsive way to avoid the problem is, after returning from RasHangUp, to call RasGetConnectStatus(hrasconn) and Sleep(0) in a loop until RasGetConnectStatus returns ERROR_INVALID_HANDLE.

See Also

RASCONN, RasDial, RasEnumConnections, RasGetConnectStatus, Sleep


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

RasHangUp



Функция RasHangUp завершает дистанционную связь доступа. Связь определена ручкой связи RAS. Функция выпускает все ресурсы RASAPI32.DLL связанные ручкой.

DWORD RasHangUp(

HRASCONN hrasconn // РУЧКА на связь RAS, чтобы отключать
);


Параметры

hrasconn

Идентифицирует дистанционную связь доступа, чтобы завершаться. Это - ручка возвращанная от предшествующего вызова до RasDial или RasEnumConnections.



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

Если функция добивается успеха, обратная величина нулевая.
Если функция терпит неудачу, обратная величина является ненулевой величиной ошибки указанной в файле заголовка RAS, или ERROR_INVALID_HANDLE.

Замечания

Связь расторгнутая даже если бы вызов RasDial еще не завершен.
После этого вызова, ручка hrasconn не может больше использован.
Приложение не должно называть RasHangUp и затем немедленно выход. Государственной машине связи нужно время, чтобы правильно завершаться. Если система преждевременно завершает государственную машину, государственная машина не может правильно закрывать порт, оставляющий порт в противоречивом состоянии. Простой путь избегать этой проблемы - называть Спать(3000) после возврата из RasHangUp; после эта пауза, приложение может выходить. Более отзывчивый путь избегать проблемы -, после возврата из RasHangUp, называть RasGetConnectStatus(hrasconn) и Сон(0) в цикле до возврат RasGetConnectStatus ERROR_INVALID_HANDLE.

Смотри Также

RASCONN, RasDial, RasEnumConnections, RasGetConnectStatus, Sleep


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