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
関数の動作を制御します。 このパラメーターには、次の値の組み合わせを指定できます。
価値 | 意味 |
---|---|
|
ネットワークからアイテムを再読み込みするかどうかを決定するときに、有効期限時間がなく、サーバーから LastModified 時刻が返されなかった場合は、強制的に再読み込みを行います。 |
|
ファイルをキャッシュできない場合は、一時ファイルを作成します。 |
|
返されたエンティティをキャッシュに追加しません。 |
|
要求されたファイル、オブジェクト、またはディレクトリの一覧をキャッシュからではなく、配信元サーバーから強制的にダウンロードします。 |
|
前回のダウンロード以降にリソースが変更された場合は、HTTP リソースを再読み込みします。 すべての FTP リソースと Gopher リソースが再読み込みされます。 |
[in] dwContext
この検索を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。
戻り値
成功した場合は有効な検索ハンドルを返し、それ以外の場合は NULL
備考
GopherFindFirstFile FindFirstFile 関数によく似ています。 Gopher サーバーとの接続を作成し、ロケーター文字列によって参照される最初の Gopher オブジェクトに関する情報を含む 1 つの構造体を返します。
GopherFindFirstFile
呼び出し元のアプリケーションが、gopherFindFirstFileによって返される
WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。
手記
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GopherFindFirstFile を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wininet.h |
ライブラリ | Wininet.lib |
DLL | Wininet.dll |
関連項目
WinINet Functions の