次の方法で共有

_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 の仕様に一致するファイルまたはファイル グループを識別する一意の検索ハンドルを返します。それ以外の場合は– 1 を返します _findfirst は次の値の 1 に errno を設定します。

  • EINVAL
    無効なパラメーター : filespec または fileinfo は NULL いません。または予期しないエラーが返されました。

  • ENOENT
    一致指定できないファイル。

  • ENOMEM
    メモリ不足。

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

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

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

解説

_findfirst または _findnext の関数が終了した後 _findclose を呼び出す必要があります (または変数)。これはアプリケーションでこれらの関数で使用されているリソースを解放します。

w のプレフィックスがこれらのバリエーションでは関数のワイド文字バージョンです。; それ以外の場合は対応するバイトの関数と同じものです。

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

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

23:59 して表現される 64 ビットの時刻型の作成日時を使用する方法 : 593000 12 年 1 月 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

必要条件

Function

必須ヘッダー

_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 系関数