次の方法で共有

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、検索する項目の名前を含む終端文字列へのポインター。 これには、次のいずれかを指定できます。

  • この関数または InternetFindNextFile 関数に対する前回の呼び出しによって返される Gopher ロケーター。
  • null ポインターまたは空の文字列は、Gopher サーバーから最上位の情報が返されていることを示します。
  • 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 Services (WinHTTP)を使用します。
 

手記

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

必要条件

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

関連項目

WinINet Functions の