InternetOpenUrlA 関数 (wininet.h)
完全な FTP または HTTP URL で指定されたリソースを開きます。
構文
HINTERNET InternetOpenUrlA(
[in] HINTERNET hInternet,
[in] LPCSTR lpszUrl,
[in] LPCSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
パラメーター
[in] hInternet
現在のインターネット セッションへのハンドル。 このハンドルは、InternetOpenへの以前の呼び出し
[in] lpszUrl
読み取りを開始する URL を指定する -terminated 文字列変数
[in] lpszHeaders
HTTP サーバーに送信されるヘッダーを指定する null終了文字列へのポインター。 詳細については、HttpSendRequest 関数の lpszHeaders パラメーターの説明を参照してください。
[in] dwHeadersLength
追加ヘッダーのサイズ (TCHAR)。 このパラメーターが -1L で、lpszHeaders
[in] dwFlags
このパラメーターには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
|
要求を行うために必要な同じ属性を持つオブジェクトが存在する場合は、既存の InternetConnect オブジェクトの使用を試みます。 FTP は通常、同じセッション中に複数の操作を実行する唯一のプロトコルであるため、これは FTP 操作でのみ役立ちます。 WinINet API は、InternetOpenによって生成された各 |
|
ネットワークからアイテムを再読み込みするかどうかを決定するときに、有効期限時間がなく、サーバーから LastModified 時刻が返されなかった場合は、強制的に再読み込みを行います。 |
|
要求で指定されたホスト名に対してサーバーから返される SSL/PCT ベースの証明書のチェックを無効にします。 WinINet 関数では、一致するホスト名と単純なワイルドカード規則を比較することで、証明書に対する単純なチェックを使用します。 |
|
SSL/PCT ベースの証明書の正しい有効期間のチェックを無効にします。 |
|
この特殊な種類のリダイレクトの検出を無効にします。 このフラグを使用すると、WinINet は HTTPS から HTTP URL へのリダイレクトを透過的に許可します。 |
|
この特殊な種類のリダイレクトの検出を無効にします。 このフラグを使用すると、WinINet は HTTP から HTTPS URL へのリダイレクトを透過的に許可します。 |
|
接続にキープアライブ セマンティクス (使用可能な場合) を使用します。 このフラグは、Microsoft Network (MSN)、NTLM、およびその他の種類の認証に必要です。 |
|
ファイルをキャッシュできない場合は、一時ファイルを作成します。 |
|
認証を自動的に試行しません。 |
|
httpSendRequestでリダイレクト |
|
返されたエンティティをキャッシュに追加しません。 |
|
要求に Cookie ヘッダーを自動的に追加せず、返された Cookie を Cookie データベースに自動的に追加しません。 |
|
Cookie ダイアログ ボックスを無効にします。 |
|
パッシブ FTP セマンティクスを使用します。 InternetOpenUrl は、FTP ファイルとディレクトリにこのフラグを使用します。 |
|
キャッシュされたコピーがプロキシ上に存在する場合でも、配信元サーバーによって要求が解決されるように強制します。 |
|
FTP ディレクトリ情報を取得するときに、データを WIN32_FIND_DATA 構造体として返します。 このフラグが指定されていない場合、または CERN プロキシを介して呼び出しが行われた場合、InternetOpenUrl はディレクトリの HTML バージョンを返します。
Windows XP および Windows Server 2003 R2 以前: Gopher ディレクトリ情報を取得するときに、データを GOPHER_FIND_DATA 構造として返します。 |
|
要求されたファイル、オブジェクト、またはディレクトリの一覧をキャッシュからではなく、配信元サーバーから強制的にダウンロードします。 |
|
前回のダウンロード以降にリソースが変更された場合は、HTTP リソースを再読み込みします。 すべての FTP リソースが再読み込みされます。
Windows XP および Windows Server 2003 R2 以前: Gopher リソースも再読み込みされます。 |
|
セキュリティで保護されたトランザクション セマンティクスを使用します。 これは、Secure Sockets Layer/Private Communications Technology (SSL/PCT) の使用に変換され、HTTP 要求でのみ意味があります。 |
[in] dwContext
返されたハンドルと共にコールバック関数に渡されるアプリケーション定義値を指定する変数へのポインター。
戻り値
接続が正常に確立された場合は URL への有効なハンドルを返し、接続が失敗した場合は NULL を
備考
使用 URL に相対 URL と空白で区切られたベース URL が含まれている場合は、最初に InternetCanonicalizeUrl を呼び出します。
これは、アプリケーションが WinINet でサポートされているプロトコルを介してデータを取得するために使用できる一般的な関数です。 この関数は、アプリケーションがプロトコルの詳細にアクセスする必要はなく、URL に対応するデータのみが必要な場合に特に便利です。
InternetOpenUrl 関数は、URL 文字列を解析し、サーバーへの接続を確立し、URL で識別されるデータをダウンロードする準備をします。 アプリケーションは、InternetReadFile (ファイルの場合) または InternetFindNextFile (ディレクトリの場合) を使用して URL データを取得できます。 InternetOpenUrlを
Windows XP および Windows Server 2003 R2 以前: InternetOpenUrl は、ポート 70 (標準の Gopher ポート) とポート 105 (通常は中央サービス組織 (CSO) 名の検索に使用される) を除き、1024 未満のポートで Gopher を無効にします。
呼び出し元のアプリケーションが、InternetOpenUrlによって返される HINTERNET ハンドルの使用を終了した後、InternetCloseHandle 関数を使用して閉じる必要があります。
WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。
手記
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetOpenUrl を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wininet.h |
| ライブラリ | Wininet.lib |
| DLL | Wininet.dll |
関連項目
WinINet Functions の