次の方法で共有

InternetOpenA 関数 (wininet.h)

  • [アーティクル]

WinINet 関数のアプリケーションの使用を初期化します。

構文

HINTERNET InternetOpenA(
  [in] LPCSTR lpszAgent,
  [in] DWORD  dwAccessType,
  [in] LPCSTR lpszProxy,
  [in] LPCSTR lpszProxyBypass,
  [in] DWORD  dwFlags
);

パラメーター

[in] lpszAgent

WinINet 関数を呼び出すアプリケーションまたはエンティティの名前を指定する、null終了文字列へのポインター。 この名前は、HTTP プロトコルのユーザー エージェントとして使用されます。

[in] dwAccessType

必要なアクセスの種類。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
INTERNET_OPEN_TYPE_DIRECT
 すべてのホスト名をローカルで解決します。
INTERNET_OPEN_TYPE_PRECONFIG
 レジストリからプロキシまたは直接構成を取得します。
INTERNET_OPEN_TYPE_PRECONFIG_WITH_NO_AUTOPROXY
 レジストリからプロキシまたは直接構成を取得し、スタートアップ Microsoft JScript またはインターネット セットアップ (INS) ファイルを使用できないようにします。
INTERNET_OPEN_TYPE_PROXY
 プロキシ バイパス リストが指定され、解決される名前がプロキシをバイパスしない限り、プロキシに要求を渡します。 この場合、関数は INTERNET_OPEN_TYPE_DIRECTを使用します。

[in] lpszProxy

dwAccessType を INTERNET_OPEN_TYPE_PROXYに設定して、プロキシ アクセスを指定するときに使用するプロキシ サーバーの名前を指定する 、null終了文字列へのポインター。 InternetOpen はプロキシ名として使用するため、空の文字列を使用しないでください。 WinINet 関数は、CERN 型プロキシ (HTTP のみ) と TIS FTP ゲートウェイ (FTP のみ) のみを認識します。 Microsoft Internet Explorer がインストールされている場合、これらの関数は SOCKS プロキシもサポートします。 FTP 要求は、CERN 型プロキシを使用して HTTP 要求に変更するか、internetOpenUrl使用して行うことができます。 dwAccessType INTERNET_OPEN_TYPE_PROXYに設定されていない場合、このパラメーターは無視され、NULLする必要があります。 プロキシ サーバーの一覧表示の詳細については、「インターネット機能のを有効にする 」の「プロキシ サーバーの 一覧表示 」セクションを参照してください。

[in] lpszProxyBypass

dwAccessType が INTERNET_OPEN_TYPE_PROXYに設定されている場合にプロキシ経由でルーティングされないホスト名または IP アドレスの省略可能なリストを指定する、null-terminated 文字列へのポインター。 リストにはワイルドカードを含めることができます。 InternetOpen はプロキシ バイパス リストとして使用するため、空の文字列を使用しないでください。 このパラメーターで "<local>" マクロが指定されている場合、この関数は、ピリオドを含まないホスト名に対してプロキシをバイパスします。

既定では、WinINet は、ホスト名 "localhost"、"ループバック"、"127.0.0.1"、または "[::1]" を使用する要求のプロキシをバイパスします。 この動作は、通常、リモート プロキシ サーバーがこれらのアドレスを正しく解決しないために存在します。Internet Explorer 9: "<-loopback>" マクロを使用して、ローカル コンピューターをプロキシ バイパス リストから削除できます。

dwAccessType INTERNET_OPEN_TYPE_PROXYに設定されていない場合、このパラメーターは無視され、NULLする必要があります。

[in] dwFlags

オプション。 このパラメーターには、次の値の組み合わせを指定できます。

価値 意味
INTERNET_FLAG_ASYNC
 この関数から返されたハンドルから派生したハンドルに対して非同期要求のみを行います。
INTERNET_FLAG_FROM_CACHE
 ネットワーク要求を行いません。 すべてのエンティティがキャッシュから返されます。 要求された項目がキャッシュにない場合は、ERROR_FILE_NOT_FOUNDなどの適切なエラーが返されます。
INTERNET_FLAG_OFFLINE
 INTERNET_FLAG_FROM_CACHEと同じです。 ネットワーク要求を行いません。 すべてのエンティティがキャッシュから返されます。 要求された項目がキャッシュにない場合は、ERROR_FILE_NOT_FOUNDなどの適切なエラーが返されます。

戻り値

アプリケーションが後続の WinINet 関数に渡す有効なハンドルを返します。 InternetOpen 失敗した場合は、NULLを返します。 特定のエラー メッセージを取得するには、GetLastError呼び出します。

備考

InternetOpen は、アプリケーションによって呼び出される最初の WinINet 関数です。 インターネット DLL に対して、内部データ構造を初期化し、アプリケーションからの今後の呼び出しに備えることを指示します。 アプリケーションは、インターネット関数の使用が完了したら、InternetCloseHandle を呼び出して、ハンドルと関連するリソースを解放する必要があります。

アプリケーションは InternetOpen任意の数の呼び出しを行うことができますが、通常は 1 回の呼び出しで十分です。 アプリケーションでは、InternetOpen インスタンスごとに個別の動作を定義する必要がある場合があります (それぞれに構成されている異なるプロキシ サーバーなど)。

呼び出し元のアプリケーションが、InternetOpenによって返される HINTERNET ハンドルの使用を終了した後、InternetCloseHandle 関数を使用して閉じる必要があります。

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

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

手記

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

必要条件

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

関連項目

インターネット機能 を有効にする

WinINet Functions の