|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
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
|
|
|
|
| |