GopherOpenFileA 関数 (wininet.h)

  • [アーティクル]

[ GopherOpenFile 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。

Gopher サーバーから Gopher データ ファイルの読み取りを開始します。

構文

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

パラメーター

[in] hConnect

InternetConnect によって返される Gopher セッションを処理します。

[in] lpszLocator

開くファイルを指定する null で終わる文字列へのポインター。 通常、このロケーターは GopherFindFirstFile または InternetFindNextFile の呼び出しから返されます。 Gopher プロトコルには現在のディレクトリの概念がないため、ロケーターは常に完全修飾されます。

[in] lpszView

サーバー上にファイルの複数のビューが存在する場合に開くビューを記述する null で終わる文字列へのポインター。 lpszView が NULL の場合、関数は既定のファイル ビューを使用します。

[in] dwFlags

後続の転送が発生する条件。 このパラメーターには、次のいずれかの値を指定できます。

値 説明
INTERNET_FLAG_HYPERLINK
 ネットワークからアイテムを再読み込みするかどうかを判断するときに、有効期限時間がなく、サーバーから LastModified 時刻が返されない場合は、強制的に再読み込みを行います。
INTERNET_FLAG_NEED_FILE
 ファイルをキャッシュできない場合は、一時ファイルを作成します。
INTERNET_FLAG_NO_CACHE_WRITE
 返されたエンティティをキャッシュに追加しません。
INTERNET_FLAG_RELOAD
 要求されたファイル、オブジェクト、またはディレクトリ リストをキャッシュからではなく元のサーバーからダウンロードします。
INTERNET_FLAG_RESYNCHRONIZE
 最後にダウンロードされてからリソースが変更された場合は、HTTP リソースを再読み込みします。 すべての FTP リソースと Gopher リソースが再読み込みされます。

[in] dwContext

この操作を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。

戻り値

成功した場合はハンドルを返し、ファイルを開くことができない場合は NULL を 返します。 拡張エラー情報を取得するには、 GetLastError または InternetGetLastResponseInfo を呼び出します。

解説

GopherOpenFile は、Gopher サーバーでファイルを開きます。 サーバーでファイルを実際に開いたりロックしたりすることができないため、この関数は場所情報を、 アプリケーションが InternetReadFile や GopherGetAttribute などのファイル ベースの操作に使用できるハンドルに関連付けるだけです。

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

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

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

注意

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

要件

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

関連項目

WinINet 関数