InternetAutodial 関数 (wininet.h)

  • [アーティクル]

モデムが既定のインターネット接続に自動的にダイヤルします。

構文

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

パラメーター

[in] dwFlags

この操作を制御します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
INTERNET_AUTODIAL_FAILIFSECURITYCHECK
0x04
 Windows 95 以降でファイルとプリンターの共有が無効になっている場合、 InternetAutodial が失敗します。

Windows Server 2008 と Windows Vista: このフラグは廃止されました。
INTERNET_AUTODIAL_FORCE_ONLINE
0x01
 オンライン インターネット接続を強制します。
INTERNET_AUTODIAL_FORCE_UNATTENDED
0x02
 無人インターネット ダイヤルアップを強制します。
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT
0x08
 インターネットへのネットワーク接続が存在する場合でも、 InternetAutodial によってモデム接続がダイヤルされます。

[in] hwndParent

親ウィンドウにハンドルします。

戻り値

関数が成功すると、 TRUE が返されます。

関数が失敗すると、 FALSE が返されます。 アプリケーションは GetLastError を 呼び出してエラー コードを取得できます。

注釈

InternetAutodial では、ダブルダイヤル接続、SmartCard 認証、またはレジストリ ベースの認定が必要な接続はサポートされていません。

メモ Windows Vista および Windows Server 2008 以降では、WinINet ダイヤルアップ関数は RAS 関数 を使用してダイヤルアップ接続を確立します。 WinINet では、 RasDialDlg 関数に記載されている機能がサポートされています。
 
システムに既存のダイヤルアップ接続がある場合、InternetAutodial はダイヤルを試みません。 また、既存の LAN 接続があり、InternetAutodial がダイヤルを強制するように構成されていない場合 (dwFlags パラメーターにINTERNET_AUTODIAL_FORCE_ONLINEを設定)、InternetAutodial は接続のダイヤルを試行せず、TRUE を返します。

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h (Wininet.h を含む)
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

インターネットへのダイヤルアップ接続の確立

WinINet 関数