共用方式為

InternetDial 函式 (winineti.h)

  • 發行項

使用數據機起始與因特網的連線。

語法

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD 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，否則傳回錯誤值。 錯誤碼可以是下列其中一個值。

傳回碼 Description
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) 。
 

規格需求

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

另請參閱

建立因特網的撥號連線

WinINet 函式