RASDIALFUNC2回呼函式 (ras.h)

發行項
03/05/2024

當遠端訪問連線程式期間發生狀態變更時， 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 對於判斷連線裝置的名稱和類型很有用。

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

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

規格需求

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