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
 [dial automatically]\(自動ダイヤル\) 設定を無視し、ダイヤル ユーザー インターフェイスを強制的に表示します。
INTERNET_DIAL_UNATTENDED
 可能であれば、ユーザー インターフェイスを表示せずに、モデムを介してインターネットに接続します。 それ以外の場合、関数はユーザー入力を待機します。
INTERNET_DIAL_SHOW_OFFLINE
 ダイヤル ユーザー インターフェイスの [キャンセル] ボタンの代わりに [オフライン作業] ボタンを表示します。

[out] lpdwConnection

接続番号を指定する変数へのポインター。 この数値は、 InternetHangUp などの他の関数で使用できる接続の一意識別子です。

[in] dwReserved

このパラメーターは予約されており、 NULL である必要があります。

戻り値

成功した場合はERROR_SUCCESS、それ以外の場合はエラー値を返します。 エラー コードには、次のいずれかの値を指定できます。

リターン コード 説明
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが正しくありません。
ERROR_NO_CONNECTION
 ダイヤルアップ接続に問題があります。
ERROR_USER_DISCONNECTION
 ユーザーが [インターネット接続] ダイアログ ボックスの [ オフライン作業 ] または [キャンセル ] ボタンをクリックしました。

注釈

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

メモ Windows Vista および Windows Server 2008 以降では、WinINet ダイヤルアップ機能は RAS 関数 を使用してダイヤルアップ接続を確立します。 WinINet では、 RasDialDlg 関数に記載されている機能がサポートされています。
 
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

注意

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetDial を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

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

WinINet 関数