RasHangUpA 函式 (ras.h)
RasHangUp 函式會終止遠端訪問連線。 線上是使用 RAS 連線句柄來指定。 函式會釋放與句柄相關聯的所有 RASAPI32.DLL 資源。
語法
DWORD RasHangUpA(
[in] HRASCONN unnamedParam1
);
參數
[in] unnamedParam1
指定要終止的遠端訪問連線。 這是從先前呼叫 RasDial 或 RasEnumConnections 傳回的句柄。
傳回值
如果函式成功,傳回值 會ERROR_SUCCESS。
如果函式失敗,傳回值是下列其中一個錯誤碼,或是 路由和遠端訪問錯誤碼 或 Winerror.h 中的值。
值 | 意義 |
---|---|
|
在 hrasconn 中指定的句柄無效。 |
備註
即使 RasDial 呼叫尚未完成,仍會終止連線。
在此呼叫之後,就無法再使用 hrasconn 句柄。
應用程式不應該呼叫 RasHangUp ,然後立即結束。 聯機狀態機器需要有時間才能正確終止。 如果系統提前終止狀態計算機,狀態機器可能無法正確關閉埠,讓埠處於不一致的狀態。 此外,立即嘗試使用相同的連線可能會失敗,讓連線無法使用。 避免這些問題的簡單方法是在從 RasHangUp 傳回之後呼叫 Sleep (3000) ;在該暫停之後,應用程式就可以結束。 避免這些問題的回應方式是從 RasHangUp 傳回之後,呼叫 RasGetConnectStatus (hrasconn) 和 Sleep (0) 迴圈,直到 RasGetConnectStatus 傳回 ERROR_INVALID_HANDLE為止。
您可以在 RasGetSubEntryHandle 所傳回的句柄上呼叫 RasHangUp,以終止多連結連線中的單一連結。 不過,在此情況下,您無法使用 RasGetConnectStatus 來判斷連結是否終止;即使連結已成功終止, RasGetConnectStatus 可能無法傳回 ERROR_INVALID_HANDLE 。
注意
ras.h 標頭會將 RasHangUp 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ras.h |
程式庫 | Rasapi32.lib |
Dll | Rasapi32.dll |