共用方式為

internetDialA 函式 (wininet.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，否則傳回錯誤值。 錯誤碼可以是下列其中一個值。

傳回碼 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 Services (WinHTTP) 。
 

注意

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

規格需求

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

另請參閱

建立因特網的撥號連線

WinINet 函式