RasSetAutodialParamA 函式 (ras.h)

  • 發行項

RasSetAutodialParam 函式會設定 AutoDial 參數的值。

語法

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

參數

[in] unnamedParam1

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

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

[out] unnamedParam2

緩衝區的指標，其中包含指定之參數的新值。

[in] unnamedParam3

指定 lpvValue 緩衝區中值的大小，以位元組為單位。

傳回值

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

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

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

備註

注意

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

RasGetAutodialParam

RasSetAutodialAddress

遠端訪問服務 (RAS) 概觀

遠端存取服務函式