raSDIALFUNC 回呼函式 (ras.h)
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 |