RasHangUpA 函式 (ras.h)

發行項
03/13/2024

RasHangUp 函式會終止遠端訪問連線。線上是使用 RAS 連線句柄來指定。函式會釋放與句柄相關聯的所有 RASAPI32.DLL 資源。

語法

DWORD RasHangUpA(
  [in] HRASCONN unnamedParam1
);

參數

[in] unnamedParam1

指定要終止的遠端訪問連線。這是從先前呼叫 RasDial 或 RasEnumConnections 傳回的句柄。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

如果函式失敗，傳回值是下列其中一個錯誤碼，或是路由和遠端訪問錯誤碼或 Winerror.h 中的值。

值	意義
ERROR_INVALID_HANDLE	在 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