RasGetAutodialParamA 函式 (ras.h)

  • 發行項

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

語法

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

參數

[in] unnamedParam1

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

值 意義
RASADP_DisableConnectionQuery
 lpvValue 參數會傳回 DWORD 值。 如果此值為零 (預設) ，自動串行化會顯示對話框，以在建立連線之前查詢使用者。 如果此值為 1，且自動串行資料庫具有撥號的電話簿專案，則自動串行化會建立連線，而不會顯示對話方塊。
RASADP_LoginSessionDisable
 lpvValue 參數會傳回 DWORD 值。 如果此值為 1，系統會停用目前登入工作階段的所有自動連線。 如果此值為零 (預設) ，則會啟用自動連線。 當新使用者登入工作站時，自動串行系統服務會將此值變更為零。
RASADP_SavedAddressesLimit
 lpvValue 參數會傳回 DWORD 值，指出自動串行化儲存在登錄中的位址數目上限。 AutoDial 會先儲存用來建立自動連線的位址;然後它會儲存在建立 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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 ras.h
程式庫 Rasapi32.lib
Dll Rasapi32.dll

另請參閱

RasSetAutodialAddress

RasSetAutodialParam

遠端訪問服務 (RAS) 概觀

遠端存取服務函式