RasHangUpA 函式（ras.h）

發行項
11/20/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）和睡眠（0）迴圈，直到 RasGetConnectStatus 傳回 ERROR_INVALID_HANDLE。

您可以在 RasGetSubEntryHandle 所傳回的句柄上呼叫 RasHangUp，以終止多連結連線中的單一連結。不過，在此情況下，您無法使用 RasGetConnectStatus 來判斷連結是否已終止;即使鏈接已順利終止，RasGetConnectStatus 可能無法傳回 ERROR_INVALID_HANDLE。

注意

ras.h 標頭會將 RasHangUp 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	ras.h
連結庫	Rasapi32.lib
DLL	Rasapi32.dll