_findnext, _wfindnext

Artykuł
02/27/2013

Znajdź następnej nazwy, jeśli odpowiada filespec argument w poprzednim wywołaniu _findfirst, a następnie zmienić fileinfo odpowiednio struktury zawartości.

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 
);

Parametry

handle
Dojście wyszukiwania zwracane przez poprzednie wywołanie _findfirst.
fileinfo
Plik informacji buforu.

Wartość zwracana

Jeśli to się powiedzie, zwraca wartość 0.W przeciwnym razie zwraca –1 i ustawia errno do wartości, wskazując rodzaj awarii.Możliwych kodów błędów są pokazane w poniższej tabeli.

EINVAL
Nieprawidłowy parametr: fileinfo został NULL.Lub system operacyjny zwrócił nieoczekiwany błąd.
ENOENT
Odnaleziono więcej nie pasujące pliki.
ENOMEM
Za mało pamięci lub długość nazwy pliku przekroczyła MAX_PATH.

Jeśli jest przekazany nieprawidłowy parametr, te funkcje wywołania obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.

Uwagi

Musisz wywołać _findclose po zakończeniu korzystania albo _findfirst lub _findnext funkcji (lub warianty).Spowoduje to zwolnienie zasobów używanych przez te funkcje w aplikacji.

Różnice te funkcje, z w prefiks są wersje szerokich znaków; w przeciwnym razie są one identyczne, odpowiadające im funkcje jednobajtowych.

Różnice te funkcje obsługi czasu 32-bitowy lub 64-bitowe typy i rozmiary pliku 32-bitowy lub 64-bitowych.Pierwszy sufiks numeryczny (32 lub 64) wskazuje rozmiar typu Godzina używane; drugi sufiks jest albo i32 lub i64, wskazując czy rozmiar pliku jest reprezentowane jako liczba całkowita 32-bitowa lub 64-bitowych.Aby uzyskać informacje o tym, które wersje obsługują czas 32-bitowych i 64-bitowe typy i rozmiary plików Zobacz następującą tabelę.Wariacje, używające typu czasu 64-bitowych zezwolić na stosowanie dat utworzenia pliku wyrażone są do 23: 59: 59, 31 grudnia, 3000, UTC; stanowią tylko typy wartości czasu 32-bitowych na tych dat przez 19: 14: 07 18 stycznia 2038, UTC.Północy, 1 stycznia 1970 r., jest dolną granicą zakres dat dla tych funkcji.

Chyba że istnieje szczególna przyczyna, aby użyć wersji, które jawnie określić wielkość czasu, należy użyć _findnext lub _wfindnext lub jeśli trzeba obsługiwać rozmiary plików, które są większe niż 3 GB, użyj _findnexti64 lub _wfindnexti64.Tych funkcji należy użyć typu czasu 64-bitowych.W poprzednich wersjach tych funkcji używany typ czasu 32-bitowych.Jeśli jest to zmiana podziału dla aplikacji, można zdefiniować _USE_32BIT_TIME_T Aby uzyskać stare zachowanie.Jeśli _USE_32BIT_TIME_T jest zdefiniowany, _findnext, _finnexti64 i odpowiadające im wersje Unicode wykorzystać czas 32-bitowych.

Typ czasu i zmian typu długość pliku _findnext

Funkcje	_USE_32BIT_TIME_Tdefinicja?	Typ czasu	Typ długość pliku
_findnext, _wfindnext	Nie zdefiniowano	64-bitowe	32-bitowe
_findnext, _wfindnext	Definicja	32-bitowe	32-bitowe
_findnext32, _wfindnext32	Nie dotyczy definicji makra	32-bitowe	32-bitowe
_findnext64, _wfindnext64	Nie dotyczy definicji makra	64-bitowe	64-bitowe
_findnexti64, _wfindnexti64	Nie zdefiniowano	64-bitowe	64-bitowe
_findnexti64, _wfindnexti64	Definicja	32-bitowe	64-bitowe
_findnext32i64, _wfindnext32i64	Nie dotyczy definicji makra	32-bitowe	64-bitowe
_findnext64i32, _wfindnext64i32	Nie dotyczy definicji makra	64-bitowe	32-bitowe

Tekst rodzajowy rutynowych mapowania

Procedura TCHAR.h	_UNICODE i _MBCS nie zdefiniowane	_MBCS, definicja	_UNICODE, definicja
_tfindnext	_findnext	_findnext	_wfindnext
_tfindnext32	_findnext32	_findnext32	_wfindnext32
_tfindnext64	_findnext64	_findnext64	_wfindnext64
_tfindnexti64	_findnexti64	_findnexti64	_wfindnexti64
_tfindnext32i64	_findnext32i64	_findnext32i64	_wfindnext32i64
_tfindnext64i32	_findnext64i32	_findnext64i32	_wfindnext64i32

Wymagania

Funkcja	Wymaganego nagłówka
_findnext	<io.h>
_findnext32	<io.h>
_findnext64	<io.h>
_findnexti64	<io.h>
_findnext32i64	<io.h>
_findnext64i32	<io.h>
_wfindnext	<io.h> lub <wchar.h>
_wfindnext32	<io.h> lub <wchar.h>
_wfindnext64	<io.h> lub <wchar.h>
_wfindnexti64	<io.h> lub <wchar.h>
_wfindnext32i64	<io.h> lub <wchar.h>
_wfindnext64i32	<io.h> lub <wchar.h>

Informacji dotyczących zgodności, zobacz zgodności we wprowadzeniu.

Biblioteki

Wszystkie wersje biblioteki uruchomieniowej c.

Odpowiednik w programie .NET Framework

Nie dotyczy. Aby wywołać standardowych funkcji C, należy użyć PInvoke. Aby uzyskać więcej informacji, zobacz Przykłady wywołać platformy.

Zobacz też

Informacje

Wywołania systemowe

_find, _wfind funkcje

Udostępnij za pośrednictwem