共用方式為

InternetDialA 函式 (winineti.h)

  • 發行項

使用數據機起始與網際網路的連線。

語法

DWORD InternetDialA(
  [in]  HWND      hwndParent,
  [in]  LPSTR     lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

參數

[in] hwndParent

父視窗的控制碼。

[in] lpszConnectoid

Null終止字串的指標，指定要使用的撥號連線名稱。 如果此參數包含空字串 (「」「) ，使用者就會選擇連線。 如果此參數為 Null，函式會連線到自動串列連接。

[in] dwFlags

選項。 此參數可以是下列其中一個值。

值 意義
INTERNET_AUTODIAL_FORCE_ONLINE
 強制連線。
INTERNET_AUTODIAL_FORCE_UNATTENDED
 強制自動網際網路撥號。 如果需要使用者介入，函式將會失敗。
INTERNET_DIAL_FORCE_PROMPT
 忽略 [自動撥號] 設定，並強制顯示撥號使用者介面。
INTERNET_DIAL_UNATTENDED
 如果可能的話，透過數據機連線到網際網路，而不顯示使用者介面。 否則，函式會等候使用者輸入。
INTERNET_DIAL_SHOW_OFFLINE
 顯示 [ 離線工作 ] 按鈕，而不是撥號使用者介面中的 [ 取消] 按鈕。

[out] lpdwConnection

指定連接編號之變數的指標。 此數位是連線的唯一識別碼，可用於其他函式，例如 InternetHangUp。

[in] dwReserved

此參數是保留的，而且必須是 Null。

傳回值

如果成功，則傳回ERROR_SUCCESS，否則傳回錯誤值。 錯誤碼可以是下列其中一個值。

傳回碼 描述
ERROR_INVALID_PARAMETER
 一或多個參數不正確。
ERROR_NO_CONNECTION
 撥號連線有問題。
ERROR_USER_DISCONNECTION
 使用者按一下 [網際網路連線] 對話方塊上的 [ 離線工作 ] 或 [ 取消] 按鈕。

備註

InternetDial 不支援雙撥號連線、智慧卡驗證或需要登錄型認證的連線。

注意 從 Windows Vista 和 Windows Server 2008 開始，WinINet 撥號函式會使用 RAS 函式來建立撥號連線。 WinINet 支援 RasDialDlg 函式中所述的功能。
 
就像 WinINet API 的其他所有層面一樣，無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。
注意 WinINet 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。
 

注意

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

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winineti.h (包括 Wininet.h、Winineti.h、Wininet.h、Winineti.h)
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

建立網際網路的撥號連線

WinINet 函式