RASADFUNCA 回呼函式（ras.h）

發行項
11/20/2024

RASADFunc 函式是一個應用程式定義的回呼函式，用來提供自定義的使用者介面來進行自動診斷。

語法

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

參數

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

傳回值

如果應用程式執行撥號作業，TRUE傳回。使用 lpdwRetCode 參數來指出撥號作業的結果。

如果應用程式未執行撥號作業，FALSE傳回。在此情況下，系統會使用預設的使用者介面進行撥號。

言論

當系統使用自訂自動處理程式啟動電話簿項目的自動串行化作業時，它會呼叫指定的 RASADFunc。 RASADFunc 可以啟動線程來執行自定義撥號作業。 RASADFunc 函式會傳回 true TRUE，表示它接管撥號，或 FALSE，讓系統執行撥號。

如果 RASADFunc 函式執行撥號作業，則會提供自己的使用者介面進行撥號，並呼叫 RasDial 函式來執行實際的撥號。接著，RASADFunc 會傳回 true ，表示它接管撥號。撥號作業完成時，請設定 lpdwRetCode 參數所指向的變數，以指出成功或失敗。

自動串行化 DLL 必須同時提供 RASADFUNCA （ANSI）和 RASADFUNCW （Unicode）版本的 RASADFunc 處理程式。若要為電話簿項目啟用 RASADFunc AutoDial 處理程式，請使用呼叫 RasSetEntryProperties 函式中的 RASENTRY 結構。 szAutodialDll 成員會指定包含處理程式的 DLL 名稱，而 szAutodialFunc 成員指定處理程式的導出名稱。 szAutodialFunc 成員不應包含 “A” 或 “W” 後綴。

RASADFunc 是連結庫定義函式名稱的佔位元。 RASADFUNC 類型是 RASADFunc 函式的指標。

注意

ras.h 標頭會根據 UNICODE 預處理器常數的定義，將 RASADFUNC 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

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