_findnext、_wfindnext
_findfirst への前の呼び出しの filespec の引数と一致して検索し次に fileinfo の構造体の内容を適切に変更します次の名前がある場合。
int _findnext(
intptr_t handle,
struct _finddata_t *fileinfo
);
int _findnext32(
intptr_t handle,
struct _finddata32_t *fileinfo
);
int _findnext64(
intptr_t handle,
struct __finddata64_t *fileinfo
);
int _findnexti64(
intptr_t handle,
struct __finddatai64_t *fileinfo
);
int _findnext32i64(
intptr_t handle,
struct _finddata32i64_t *fileinfo
);
int _findnext64i32(
intptr_t handle,
struct _finddata64i32_t *fileinfo
);
int _wfindnext(
intptr_t handle,
struct _wfinddata_t *fileinfo
);
int _wfindnext32(
intptr_t handle,
struct _wfinddata32_t *fileinfo
);
int _wfindnext64(
intptr_t handle,
struct _wfinddata64_t *fileinfo
);
int _wfindnexti64(
intptr_t handle,
struct _wfinddatai64_t *fileinfo
);
int _wfindnext32i64(
intptr_t handle,
struct _wfinddatai64_t *fileinfo
);
int _wfindnext64i32(
intptr_t handle,
struct _wfinddata64i32_t *fileinfo
);
パラメーター
handle
_findfirst への前の呼び出しによって返される検索ハンドル。fileinfo
ファイル情報バッファー。
戻り値
成功するとは 0 を返します。はを返します。失敗の種類を示す値に 1 を設定 errno。発生する可能性のあるエラー コードを次の表に示します。
EINVAL
無効なパラメーター : fileinfo は NULL いません。または予期しないエラーが返されました。ENOENT
これ以上一致するファイルが見つかりません。ENOMEM
メモリ不足のためまたはファイル名の長さは MAX_PATH を超えるされていません。
無効なパラメーターが渡されるとこれらの関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。
解説
_findfirst または _findnext の関数を使用した後は _findclose を呼び出す必要があります (または変数)。これはアプリケーションでこれらの関数で使用されているリソースを解放します。にします。
w のプレフィックスの付いたこれらの関数の違いはワイド文字バージョンです。; それ以外の場合は対応するバイトの関数と同じものです。
これらの関数のバリエーションが 32 ビットまたは 64 ビットの時刻型および 32 ビットまたは 64 ビットのファイル サイズをサポートします。最初の数字サフィックス (32 または 64) は使用されている時刻型のサイズを表し、2 番目のサフィックス (i32 または i64) はファイル サイズが 32 ビットまたは 64 ビットのどちらの整数値で表されているかを示します。バージョンが 32 ビットと 64 ビットの時刻型およびファイル サイズをサポートするついては次の表を参照してください。23:59 して表現される 64 ビットの時刻型の作成日時を使用する方法 : 593000 12 年 1 月 31 日(UTC); 32 ビットの時刻型を使用して19:14 だけで日付を表す場合 : 1 年 1 月 07 日 18 時 2038 の UTC。は1970 年が 1 年 1 月 1 日これらのすべての関数の日付範囲の下限はです。
時間のサイズを明示的に指定するバージョンを使用する特別な理由がない限り使用 _findnext または _wfindnext またはファイルの最大サイズは 3 GB をサポートする必要がある _findnexti64 使用するかを _wfindnexti64。これらの関数はすべて 64 ビットの時刻型を使用します。以前のバージョンではこれらの関数は 32 ビットの時刻型を使用します。これはアプリケーションの互換性に影響の場合古い動作を取得するに _USE_32BIT_TIME_T を定義する必要があります。_USE_32BIT_TIME_T が定義されている場合_findnext_finnexti64 および対応する Unicode バージョンは 32 ビットの時刻を使用します。
_findnext の時刻型およびファイル長の種類の変更
関数 |
_USE_32BIT_TIME_T で定義したか。 |
時刻型 |
ファイル長の種類 |
---|---|---|---|
_findnext, _wfindnext |
定義なし |
64 ビット |
32 ビット |
_findnext, _wfindnext |
定義あり |
32 ビット |
32 ビット |
_findnext32, _wfindnext32 |
マクロ定義の影響は受けません |
32 ビット |
32 ビット |
_findnext64, _wfindnext64 |
マクロ定義の影響は受けません |
64 ビット |
64 ビット |
_findnexti64, _wfindnexti64 |
定義なし |
64 ビット |
64 ビット |
_findnexti64, _wfindnexti64 |
定義あり |
32 ビット |
64 ビット |
_findnext32i64, _wfindnext32i64 |
マクロ定義の影響は受けません |
32 ビット |
64 ビット |
_findnext64i32, _wfindnext64i32 |
マクロ定義の影響は受けません |
64 ビット |
32 ビット |
汎用テキスト ルーチンのマップ
Tchar.h のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
---|---|---|---|
_tfindnext |
_findnext |
_findnext |
_wfindnext |
_tfindnext32 |
_findnext32 |
_findnext32 |
_wfindnext32 |
_tfindnext64 |
_findnext64 |
_findnext64 |
_wfindnext64 |
_tfindnexti64 |
_findnexti64 |
_findnexti64 |
_wfindnexti64 |
_tfindnext32i64 |
_findnext32i64 |
_findnext32i64 |
_wfindnext32i64 |
_tfindnext64i32 |
_findnext64i32 |
_findnext64i32 |
_wfindnext64i32 |
必要条件
Function |
必須ヘッダー |
---|---|
_findnext |
<io.h> |
_findnext32 |
<io.h> |
_findnext64 |
<io.h> |
_findnexti64 |
<io.h> |
_findnext32i64 |
<io.h> |
_findnext64i32 |
<io.h> |
_wfindnext |
<io.h> または <wchar.h> |
_wfindnext32 |
<io.h> または <wchar.h> |
_wfindnext64 |
<io.h> または <wchar.h> |
_wfindnexti64 |
<io.h> または <wchar.h> |
_wfindnext32i64 |
<io.h> または <wchar.h> |
_wfindnext64i32 |
<io.h> または <wchar.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。