raSDIALFUNC 回呼函式 (ras.h)

發行項
03/05/2024

RasDialFunc 回呼函式會在 RAS 連線程式期間發生狀態變更時由 RasDial 函式呼叫。

語法

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

參數

unnamedParam1

unnamedParam2

unnamedParam3

傳回值

無

備註

RasDial 連線作業會在呼叫 RasDialFunc 回呼函式期間暫停。基於這個理由， RasDialFunc 實作通常應該儘快傳回。該規則有兩個例外。異步 (緩慢的) 裝置，例如數據機，通常會以秒為單位來測量逾時期間，而不是毫秒; RasDialFunc 函式的緩慢傳回通常不是問題。 當 dwError 為非零時，提示傳回需求也不適用，表示發生錯誤。例如，放置錯誤對話框並等候使用者輸入是安全的。

RasDialFunc 實作不應該相依於特定 RASCONNSTATE 連線狀態的順序或出現次數，因為這在平台之間可能會有所不同。

請勿從 RasDialFunc 回呼函式內呼叫 RasDial 函式。從回呼函式內呼叫 RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString 和 RasHangUp 函式。例如，從回調函式內呼叫 RasGetConnectStatus 有助於判斷連線裝置的名稱和類型。

注意為了方便起見，可以從 RasDialFunc 回呼函式內呼叫 RasHangUp。不過，大部分的停止響應處理會在 RasDialFunc 回呼函式傳回之後發生。

注意RasDialFunc 是應用程式定義或連結庫定義函數名稱的佔位元。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	ras.h