次の方法で共有

InternetDialW 関数 (wininet.h)

  • [アーティクル]

モデムを使用してインターネットへの接続を開始します。

構文

DWORD InternetDialW(
  [in]  HWND      hwndParent,
  [in]  LPWSTR    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 Services (WinHTTP)を使用します。
 

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h (Wininet.h、Winineti.h、Wininet.h、Winineti.h を含む)
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

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

WinINet Functions の