共用方式為

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

傳回碼 描述
ERROR_INVALID_PARAMETER
 一或多個參數不正確。
ERROR_NO_CONNECTION
 撥號聯機發生問題。
ERROR_USER_DISCONNECTION
 用戶按兩下 [因特網連線] 對話方塊上的 [Work Offline] 或 [取消] 按鈕。

言論

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

注意從 Windows Vista 和 Windows Server 2008 開始，WinINet 撥號函式會使用 RAS 函式 建立撥號連線。 WinINet 支援 RasDialDlg 函式中記載的功能。
 
如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意 WinINet 不支援伺服器實作。 此外，不應該從服務使用。 針對伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 （WinHTTP）。
 

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wininet.h （包括 Wininet.h、Winineti.h、Wininet.h、Winineti.h）
連結庫 Wininet.lib
DLL Wininet.dll

另請參閱

建立因特網的撥號連線

WinINet 函式