InternetDialA 関数 (winineti.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
オプション。 このパラメーターには、次の値のいずれかを指定できます。
値 | 説明 |
---|---|
|
強制的にオンライン接続します。 |
|
無人インターネット ダイヤルアップを強制します。 ユーザーの介入が必要な場合、関数は失敗します。 |
|
[dial automatically]\(自動ダイヤル\) 設定を無視し、ダイヤル ユーザー インターフェイスを強制的に表示します。 |
|
可能であれば、ユーザー インターフェイスを表示せずに、モデムを介してインターネットに接続します。 それ以外の場合、関数はユーザー入力を待機します。 |
|
ダイヤル ユーザー インターフェイスの [キャンセル] ボタンの代わりに [オフライン作業] ボタンを表示します。 |
[out] lpdwConnection
接続番号を指定する変数へのポインター。 この数値は、 InternetHangUp などの他の関数で使用できる接続の一意識別子です。
[in] dwReserved
このパラメーターは予約されており、 NULL である必要があります。
戻り値
成功した場合はERROR_SUCCESS、それ以外の場合はエラー値を返します。 エラー コードには、次のいずれかの値を指定できます。
リターン コード | 説明 |
---|---|
|
1 つ以上のパラメーターが正しくありません。 |
|
ダイヤルアップ接続に問題があります。 |
|
ユーザーが [インターネット接続] ダイアログ ボックスの [ オフライン作業 ] または [キャンセル ] ボタンをクリックしました。 |
解説
InternetDial では、ダブルダイヤル接続、SmartCard 認証、またはレジストリ ベースの認定を必要とする接続はサポートされていません。
Note
winineti.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetDial を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | winineti.h (Wininet.h、Winineti.h、Wininet.h、Winineti.h を含む) |
Library | Wininet.lib |
[DLL] | Wininet.dll |