RASDIALFUNC2回呼函式 (ras.h)
當遠端訪問連線程式期間發生狀態變更時, RasDial 函式會呼叫 RasDialFunc2回 呼函式。 RasDialFunc2 函式類似於 RasDialFunc1 回呼函式,不同之處在於它會提供多連結連線的其他資訊。
語法
RASDIALFUNC2 Rasdialfunc2;
DWORD Rasdialfunc2(
ULONG_PTR unnamedParam1,
DWORD unnamedParam2,
HRASCONN unnamedParam3,
UINT unnamedParam4,
tagRASCONNSTATE unnamedParam5,
DWORD unnamedParam6,
DWORD unnamedParam7
)
{...}
參數
unnamedParam1
unnamedParam2
unnamedParam3
unnamedParam4
unnamedParam5
unnamedParam6
unnamedParam7
傳回值
如果 RasDialFunc2 函式傳回非零值, RasDial 會繼續傳送回呼通知。
如果 RasDialFunc2 函式傳回零, RasDial 會停止傳送所有子專案的回呼通知。
備註
RasDial 連線作業會在呼叫 RasDialFunc2 回呼函式期間暫停。 因此, RasDialFunc2 實作通常會儘快傳回。 該規則有兩個例外。 異步 (緩慢的) 裝置,例如數據機,通常會以秒為單位來測量逾時期間,而不是毫秒; RasDialFunc2 函式的緩慢傳回通常不是問題。 當 dwError 為非零時,提示傳回需求也不適用,表示發生錯誤。 例如,放置錯誤對話框並等候使用者輸入是安全的。
RasDialFunc2 實作不應相依於特定 RASCONNSTATE 連線狀態的順序或出現次數,因為這可能會因平臺而異。
請勿從 RasDialFunc2 回呼函式內呼叫 RasDial 函式。 從回呼函式內呼叫 RasGetConnectStatus、 RasEnumEntries、 RasEnumConnections、 RasGetErrorString 和 RasHangUp 函式。 例如,從回呼函式內呼叫 RasGetConnectStatus 對於判斷連線裝置的名稱和類型很有用。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | ras.h |