InternetDial

InternetDial 関数 (wininet.h) はモデムを使用してインターネットへの接続を開始する。

InternetDial hwndParent, lpszConnectoid, dwFlags, lpdwConnection, dwReserved

hwndParent : [intptr] 親ウィンドウへのハンドル。
lpszConnectoid : [str] 使用するダイアルアップ接続の名前を指定する null 終端文字列へのポインタ。本パラメータに空文字列 ("") を指定した場合、ユーザーが接続を選択する。本パラメータが NULL の場合、関数は自動ダイアル接続に接続する。
dwFlags : [int] 
lpdwConnection : [var] 接続番号を指定する変数へのポインタ。この番号は接続の一意な識別子であり、InternetHangUp など他の関数で使用できる。
dwReserved : [int] 本パラメータは予約されており、NULL を指定しなければならない。

(プラグイン / モジュール : wininet.dll)

解説

InternetDial 関数 (wininet.h) はモデムを使用してインターネットへの接続を開始する。

[戻り値]
成功した場合は ERROR_SUCCESS を、失敗した場合はエラー値を返す。エラーコードは次のいずれかである。
(以下省略)

[備考]
InternetDial はダブルダイアル接続、SmartCard
認証、レジストリベースの証明書を必要とする接続をサポートしていない。注意: Windows Vista および Windows
Server 2008 以降、WinINet のダイアルアップ関数はダイアルアップ接続を確立するために RAS
関数を使用する。WinINet は RasDialDlg 関数で文書化されている機能をサポートしている。WinINet API
の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。

情報

プラグイン / モジュールwininet.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の wininet.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_wininet_gen2.hs