次の方法で共有

_findfirst、_wfindfirst

  • [アーティクル]

filespec 引数に指定されたファイルと一致するファイル名を最初のインスタンスに関する情報を提供します。

intptr_t _findfirst(
   const char *filespec,
   struct _finddata_t *fileinfo 
);
intptr_t _findfirst32(
   const char *filespec,
   struct _finddata32_t *fileinfo 
);
intptr_t _findfirst64(
   const char *filespec,
   struct _finddata64_t *fileinfo 
);
intptr_t _findfirsti64(
   const char *filespec,
   struct _finddatai64_t *fileinfo 
);
intptr_t _findfirst32i64(
   const char *filespec,
   struct _finddata32i64_t *fileinfo 
);
intptr_t _findfirst64i32(
   const char *filespec,
   struct _finddata64i32_t *fileinfo 
);
intptr_t _wfindfirst(
   const wchar_t *filespec,
   struct _wfinddata_t *fileinfo 
);
intptr_t _wfindfirst32(
   const wchar_t *filespec,
   struct _wfinddata32_t *fileinfo 
);
intptr_t _wfindfirst64(
   const wchar_t *filespec,
   struct _wfinddata64_t *fileinfo 
);
intptr_t _wfindfirsti64(
   const wchar_t *filespec,
   struct _wfinddatai64_t *fileinfo 
);
intptr_t _wfindfirst32i64(
   const wchar_t *filespec,
   struct _wfinddata32i64_t *fileinfo 
);
intptr_t _wfindfirst64i32(
   const wchar_t *filespec,
   struct _wfinddata64i32_t *fileinfo 
);

パラメーター

  • filespec
    ターゲット ファイルの指定 (ワイルドカード文字を含めることができます。

  • fileinfo
    ファイル情報バッファー。

戻り値

成功すると、_findfirst は _findnext または _findcloseへの後続の呼び出しで使用できる、filespec 仕様に一致するファイルのファイルまたはグループを識別する一意の検索ハンドルを返します。 それ以外の場合は _findfirst は–1 を返し、次の値のいずれか 1 つがに errno を設定します。

  • EINVAL
    無効なパラメーターです: filespec または fileinfo は NULLでした。 または、オペレーティング システムは、予期しないエラーが返されました。

  • ENOENT
    一致するファイルの指定。

  • ENOMEM
    メモリ不足です。

  • EINVAL
    無効なファイル名の指定に指定されたファイル名が MAX_PATHを超えています。

リターン コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

無効なパラメーターが渡されると、これらの関数は パラメーターの検証"に説明されているように、無効なパラメーター ハンドラーを呼び出します。

解説

_findfirst または _findnext 関数と終了後 _findclose (または VARIANT)。 これにより、アプリケーションでこれらの関数によって使用されるリソースを解放します。

w で始まるこれらのバリエーションが関数のワイド文字バージョンであり、; それ以外の場合は、対応する前の関数と同じです。

これらの関数のバリエーションが 32 ビットまたは 64 ビットの時刻型、および 32 ビットまたは 64 ビットのファイル サイズをサポートします。 最初の数字サフィックス (32 または 64) 時刻型のサイズを表し、; 2 番目のサフィックスは i32 または i64で、ファイル サイズが 32 ビットまたは 64 ビットの整数として表されるかを示します。 バージョンが 32 ビットと 64 ビットの時刻型、およびファイル サイズをサポートする詳細については、次の表を参照してください。 i32 または i64 サフィックスが時刻型のサイズと同じため、_findfirst64 は、64 ビットのファイル長をサポートする場合 _findfirst32 は 32 ビット ファイル長だけをサポートする省略されます。

これらの関数は fileinfo パラメーターに _finddata_t のさまざまな形式の構造を使用します。 構造体の詳細については、「_find、_wfind 系関数」を参照してください。

23:59 で表現される 64 ビットの時刻型の作成日を使用するバリエーション: 59、3000 12 年 10 月 31 日は、UTC。 32 ビットの時刻型が使用される場合は 19:14 のみで日付を表します: 1 年 1 月 07 日 18 時 2038、UTC。 午前 1970 は 1 年 1 月 1 日、これらすべての関数の日付範囲の下限です。

時のサイズを明示的に指定するバージョンを使用する特別な理由がある場合、使用 _findfirst または _wfindfirst またはより大きい 3 GB ファイル サイズをサポートする必要がある場合は、使用する _findfirsti64 または _wfindfirsti64を。 これらの関数はすべて、64 ビットの時刻型を使用します。 以前のバージョンでは、これらの関数は 32 ビットの時刻型を使用します。 これにより、アプリケーションの重要な変更は、古い動作に戻すに _USE_32BIT_TIME_T を定義する必要があります。 _USE_32BIT_TIME_T が定義されている場合、_findfirst、_finfirsti64および Unicode 対応するバージョンは 32 ビットの時刻を使用します。

_findfirst の時刻型、およびファイル長の種類のバリエーション

関数

_USE_32BIT_TIME_T で 定義したか。

時刻型

ファイル長の種類

_findfirst, _wfindfirst

定義なし

64 ビット

32 ビット

_findfirst, _wfindfirst

定義済み

32 ビット

32 ビット

_findfirst32, _wfindfirst32

マクロ定義の影響は受けません

32 ビット

32 ビット

_findfirst64, _wfindfirst64

マクロ定義の影響は受けません

64 ビット

64 ビット

_findfirsti64, _wfindfirsti64

定義なし

64 ビット

64 ビット

_findfirsti64, _wfindfirsti64

定義済み

32 ビット

64 ビット

_findfirst32i64, _wfindfirst32i64

マクロ定義の影響は受けません

32 ビット

64 ビット

_findfirst64i32, _wfindfirst64i32

マクロ定義の影響は受けません

64 ビット

32 ビット

汎用テキスト ルーチンのマップ

Tchar.h のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tfindfirst

_findfirst

_findfirst

_wfindfirst

_tfindfirst32

_findfirst32

_findfirst32

_wfindfirst32

_tfindfirst64

_findfirst64

_findfirst64

_wfindfirst64

_tfindfirsti64

_findfirsti64

_findfirsti64

_wfindfirsti64

_tfindfirst32i64

_findfirst32i64

_findfirst32i64

_wfindfirst32i64

_tfindfirst64i32

_findfirst64i32

_findfirst64i32

_wfindfirst64i32

必要条件

関数

必須ヘッダー

_findfirst

<io.h>

_findfirst32

<io.h>

_findfirst64

<io.h>

_findfirsti64

<io.h>

_findfirst32i64

<io.h>

_findfirst64i32

<io.h>

_wfindfirst

<io.h または> wchar.h <>

_wfindfirst32

<io.h または> wchar.h <>

_wfindfirst64

<io.h または> wchar.h <>

_wfindfirsti64

<io.h または> wchar.h <>

_wfindfirst32i64

<io.h または> wchar.h <>

_wfindfirst64i32

<io.h または> wchar.h <>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

同等の .NET Framework 関数

System::IO::DirectoryInfo::GetFiles

参照

関連項目

システム コール

_find、_wfind 系関数