GopherFindFirstFileW

Gopher ロケータと検索条件を使用してサーバーとのセッションを作成し、要求された文書、バイナリファイル、インデックスサーバー、またはディレクトリツリーを検索する。(Unicode)

GopherFindFirstFileW hConnect, lpszLocator, lpszSearchString, lpFindData, dwFlags, dwContext

hConnect : [intptr] InternetConnect から返された Gopher セッションへのハンドル。
lpszLocator : [wstr] 検索する項目の名前を格納した null 終端文字列へのポインタ。次のいずれかを指定できる。
lpszSearchString : [wstr] 本要求がインデックスサーバーへのものである場合、検索する文字列を格納したバッファへのポインタ。それ以外の場合、本パラメータは NULL を指定すべきである。
lpFindData : [var] 本関数で取得した情報を受け取る GOPHER_FIND_DATA 構造体へのポインタ。
dwFlags : [int] 
dwContext : [int] 本検索を任意のアプリケーションデータと関連付けるアプリケーション定義の値を格納した変数へのポインタ。

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

解説

Gopher
ロケータと検索条件を使用してサーバーとのセッションを作成し、要求された文書、バイナリファイル、インデックスサーバー、またはディレクトリツリーを検索する。(Unicode)

[戻り値]
成功した場合は有効な検索ハンドルを、失敗した場合は NULL を返す。拡張エラー情報を取得するには GetLastError または
InternetGetLastResponseInfo を呼び出す。

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

情報