RASDIALFUNC1回呼函式 (ras.h)

發行項
03/01/2024

當遠端訪問連線程式期間發生狀態變更時，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