共用方式為

RasGetAutodialParamA 函式 （ras.h）

  • 發行項

RasGetAutodialParam 函式會擷取 AutoDial 參數的值。

語法

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

參數

[in] unnamedParam1

指定要擷取的 AutoDial 參數。 此參數可以是下列其中一個值。

價值 意義
RASADP_DisableConnectionQuery
 lpvValue 參數會傳回 DWORD 值。 如果此值為零（預設值），自動串行化會顯示對話框，以在建立連接之前查詢使用者。 如果此值為 1，且 AutoDial 資料庫具有要撥號的電話簿專案，則 AutoDial 會建立連接而不顯示對話方塊。
RASADP_LoginSessionDisable
 lpvValue 參數會傳回 DWORD 值。 如果此值為 1，系統會停用目前登入工作階段的所有自動連線。 如果此值為零（預設值），則會啟用自動連線。 當新的使用者登入工作站時，自動串行系統服務會將此值變更為零。
RASADP_SavedAddressesLimit
 lpvValue 參數會傳回 DWORD 值，指出自動串行化儲存在登錄中的位址數目上限。 自動串行化會先儲存用來建立自動連線的位址;然後它會儲存建立 RAS 連線之後所學到的位址。 使用 RasSetAutodialAddress 函式所撰寫的位址一律會儲存，而且不會包含在計算限制中。 預設值為 100。
RASADP_FailedConnectionTimeout
 lpvValue 參數會傳回 DWORD 值，以秒為單位表示逾時值。 當自動連線嘗試失敗時，自動串行系統服務會停用後續嘗試在逾時期間達到相同的位址。 這可防止自動串行化顯示應用程式相同邏輯要求的多個連線對話框。 預設值為 5。
RASADP_ConnectionQueryTimeout
 lpvValue 參數會指向以秒為單位表示逾時值的 DWORD 值。 嘗試自動連線之前，系統會顯示對話方塊，要求使用者確認系統應該撥打。 對話框具有倒數定時器，當使用者不採取任何動作時，會終止具有「不要撥號」選取範圍的對話方塊。 lpvValue 所指向 DWORD 值會指定此倒數定時器的初始時間。

[out] unnamedParam2

接收指定參數值的緩衝區指標。

[in, out] unnamedParam3

DWORD 值的指標。

在輸入上，將此值設定為表示 lpvValue 緩衝區的大小，以位元組為單位。

在輸出中，這個值表示寫入緩衝區之值的實際大小。

傳回值

如果函式成功，則傳回值會 ERROR_SUCCESS。

如果函式失敗，傳回值是下列其中一個錯誤碼，或來自 路由和遠端訪問錯誤碼的值 或 Winerror.h。

價值 意義
ERROR_INVALID_PARAMETER
 dwKey 或 lpvValue 參數無效。
ERROR_INVALID_SIZE
 lpdwcbValue 所指定的大小太小。

言論

注意

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

要求

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

另請參閱

RasSetAutodialAddress

RasSetAutodialParam

遠端存取服務 （RAS） 概觀

遠端訪問服務函式