次の方法で共有


_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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

システム コール

_find、_wfind 系関数