GopherOpenFileW

Gopher サーバーから Gopher データファイルの読み取りを開始する。(Unicode)

GopherOpenFileW hConnect, lpszLocator, lpszView, dwFlags, dwContext

hConnect : [intptr] InternetConnect から返された Gopher セッションへのハンドル。
lpszLocator : [wstr] 開くファイルを指定する null 終端文字列へのポインタ。一般に、このロケータは GopherFindFirstFile または InternetFindNextFile の呼び出しから返される。Gopher プロトコルにはカレントディレクトリの概念がないため、ロケータは常に完全修飾である。
lpszView : [wstr] サーバー上にファイルの複数のビューが存在する場合に開くビューを記述する null 終端文字列へのポインタ。lpszView が NULL の場合、関数は既定のファイルビューを使用する。
dwFlags : [int] 
dwContext : [int] 本操作を任意のアプリケーションデータと関連付けるアプリケーション定義の値を格納した変数へのポインタ。

(プラグイン / モジュール : wininet.dll)

解説

Gopher サーバーから Gopher データファイルの読み取りを開始する。(Unicode)

[戻り値]
成功した場合はハンドルを、ファイルを開けなかった場合は NULL を返す。拡張エラー情報を取得するには GetLastError または
InternetGetLastResponseInfo を呼び出す。

[備考]
GopherOpenFile は Gopher
サーバー上のファイルを開く。サーバー上で実際にファイルを開いたりロックしたりすることはできないため、本関数は単に、InternetReadFile
や GopherGetAttribute
などのファイルベースの操作にアプリケーションが使用できるハンドルに位置情報を関連付けるだけである。呼び出し側アプリケーションが
GopherOpenFile によって返された HINTERNET ハンドルの使用を終えたら、InternetCloseHandle
関数で閉じなければならない。WinINet API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは GopherOpenFile をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報