_findnext、_wfindnext

[アーティクル]
02/21/2013

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

Share via

_findnext、_wfindnext

パラメーター

戻り値

解説

必要条件

ライブラリ

同等の .NET Framework 関数

参照

関連項目

その他のリソース