次の方法で共有

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

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

[in] lpszView

null-terminated 文字列へのポインター。サーバー上にファイルの複数のビューが存在する場合に開くビューを記述します。 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 Services (WinHTTP)を使用します。
 

手記

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

必要条件

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

関連項目

WinINet Functions の