GopherFindFirstFileA 関数 (wininet.h)

  • [アーティクル]

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

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

構文

HINTERNET GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA lpFindData,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

パラメーター

[in] hConnect

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

[in] lpszLocator

検索する項目の名前を含む null で終わる文字列へのポインター。 DLL は、次のいずれかの場所に置くことができます。

  • この関数または InternetFindNextFile 関数の以前の呼び出しによって返される Gopher ロケーター。
  • Gopher サーバーから最上位の情報が返されることを示す NULL ポインターまたは空の文字列。
  • GopherCreateLocator 関数によって作成されたロケーター。

[in] lpszSearchString

この要求がインデックス サーバーに対する場合は、検索する文字列を含むバッファーへのポインター。 それ以外の場合、このパラメーターは NULL にする必要があります。

[out] lpFindData

この関数によって取得された情報を受け取る GOPHER_FIND_DATA 構造体へのポインター。

[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 を呼び出します。

解説

GopherFindFirstFile はFindFirstFile 関数によく似ています。 Gopher サーバーとの接続を作成し、ロケーター文字列によって参照される最初の Gopher オブジェクトに関する情報を含む 1 つの構造体を返します。

GopherFindFirstFile を呼び出して列挙体の最初の Gopher オブジェクトを取得した後、アプリケーションは InternetFindNextFile 関数を使用して後続の Gopher オブジェクトを取得できます。

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

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

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

注意

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

要件

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

関連項目

WinINet 関数