RASDIALFUNC1回呼函式 (ras.h)
當遠端訪問連線程式期間發生狀態變更時,RasDial 函式會呼叫 RasDialFunc1 函式。 RasDialFunc1 函式相當於 RasDialFunc 函式,但會藉由新增兩個參數來增強:RAS 連線的句柄,以及擴充的錯誤碼。
語法
RASDIALFUNC1 Rasdialfunc1;
void Rasdialfunc1(
HRASCONN unnamedParam1,
UINT unnamedParam2,
tagRASCONNSTATE unnamedParam3,
DWORD unnamedParam4,
DWORD unnamedParam5
)
{...}
參數
unnamedParam1
unnamedParam2
unnamedParam3
unnamedParam4
unnamedParam5
傳回值
無
備註
RasDial 連線作業會在呼叫 RasDialFunc1 回呼函式期間暫停。 因此, RasDialFunc1 實作通常會儘快傳回。 該規則有兩個例外。 異步 (緩慢的) 裝置,例如數據機,通常會以秒為單位來測量逾時期間,而不是毫秒; RasDialFunc1 函式的緩慢傳回通常不是問題。 當 dwError 為非零時,提示傳回需求也不適用,表示發生錯誤。 例如,放置錯誤對話框並等候使用者輸入是安全的。
RasDialFunc1 實作不應取決於特定 RASCONNSTATE 連線狀態的順序或出現次數,因為這在平台之間可能會有所不同。
請勿從 RasDialFunc1 回呼函式內呼叫 RasDial 函式。 從回呼函式內呼叫 RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString 和 RasHangUp 函式。 例如,從回呼函式內呼叫 RasGetConnectStatus 對於判斷連線裝置的名稱和類型很有用。
請注意,為了方便起見,可以從 RasDialFunc1 回呼函式內呼叫 RasHangUp。 不過,大部分的停止響應處理會在 RasDialFunc1 回呼函式傳回之後發生。
RasDialFunc1 是應用程式定義或連結庫定義函數名稱的佔位元。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ras.h |