_findnext, _findnext32, _findnext32i64, _findnext64, _findnext64i32, _findnexti64, _wfindnext, _wfindnext32, _wfindnext32i64, _wfindnext64, _wfindnext64i32, _wfindnexti64

Znajdź następną nazwę, jeśli istnieje, która pasuje do argumentu filespec w poprzednim wywołaniu metody _findfirst, a następnie odpowiednio zmień fileinfo zawartość struktury.

Składnia

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 zwrócone przez poprzednie wywołanie metody _findfirst.

fileinfo
Bufor informacji o pliku.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca wartość 0. W przeciwnym razie zwraca wartość -1 i ustawia errno wartość wskazującą charakter błędu. Możliwe kody błędów są wyświetlane w poniższej tabeli.

errno Wartość	Stan
EINVAL	Nieprawidłowy parametr: fileinfo to NULL. Lub system operacyjny zwrócił nieoczekiwany błąd.
ENOENT	Nie można odnaleźć więcej pasujących plików.
ENOMEM	Za mało pamięci lub długość nazwy pliku przekroczyła MAX_PATHwartość .

Jeśli przekazano nieprawidłowy parametr, te funkcje wywołują nieprawidłową procedurę obsługi parametrów zgodnie z opisem w temacie Weryfikacja parametrów.

Uwagi

Musisz wywołać metodę _findclose po zakończeniu _findfirst korzystania z funkcji lub _findnext (lub dowolnych wariantów). _findclose Zwalnia zasoby używane przez te funkcje w aplikacji.

Odmiany tych funkcji z prefiksem w są wersjami szerokiego znaku; w przeciwnym razie są identyczne z odpowiednimi funkcjami jednobajtowymi.

Odmiany tych funkcji obsługują typy czasu 32-bitowego lub 64-bitowego oraz 32-bitowe lub 64-bitowe rozmiary plików. Pierwszy sufiks liczbowy (32 lub 64) wskazuje rozmiar używanego typu czasu; drugi sufiks to i32 lub i64, wskazując, czy rozmiar pliku jest reprezentowany jako 32-bitowa lub 64-bitowa liczba całkowita. Aby uzyskać informacje o tym, które wersje obsługują 32-bitowe i 64-bitowe typy czasu i rozmiary plików, zobacz poniższą tabelę. Odmiany, które używają typu czasu 64-bitowego, umożliwiają wyrażenia dat tworzenia plików do 23:59:59, 31 grudnia 3000, UTC; natomiast osoby korzystające z typów czasu 32-bitowego reprezentują tylko daty do 23:59:59 stycznia 18, 2038 r. UTC. Północ, 1 stycznia 1970 r., jest dolną granicą zakresu dat dla wszystkich tych funkcji.

Jeśli nie masz określonego powodu, aby użyć wersji, które jawnie określą rozmiar czasu, użyj _findnext polecenia lub _wfindnext , jeśli musisz obsługiwać rozmiary plików większe niż 3 GB, użyj polecenia _findnexti64 lub _wfindnexti64. Wszystkie te funkcje używają typu czasu 64-bitowego. W poprzednich wersjach te funkcje używały 32-bitowego typu czasu. Jeśli ta zmiana dotyczy zmiany powodującej niezgodność dla aplikacji, możesz zdefiniować _USE_32BIT_TIME_T , aby uzyskać stare zachowanie. Jeśli _USE_32BIT_TIME_T jest zdefiniowana, _findnext, _findnexti64 a odpowiadające im wersje Unicode używają czasu 32-bitowego.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Odmiany typu czasu i typu długości pliku _findnext

Funkcje	_USE_32BIT_TIME_T Zdefiniowane?	Typ godziny	Typ długości pliku
_findnext, _wfindnext	Nieokreślona	64-bitowa	32-bitowa
_findnext, _wfindnext	Zdefiniowane	32-bitowa	32-bitowa
_findnext32, _wfindnext32	Nie ma to wpływu na definicję makra	32-bitowa	32-bitowa
_findnext64, _wfindnext64	Nie ma to wpływu na definicję makra	64-bitowa	64-bitowa
_findnexti64, _wfindnexti64	Nieokreślona	64-bitowa	64-bitowa
_findnexti64, _wfindnexti64	Zdefiniowane	32-bitowa	64-bitowa
_findnext32i64, _wfindnext32i64	Nie ma to wpływu na definicję makra	32-bitowa	64-bitowa
_findnext64i32, _wfindnext64i32	Nie ma to wpływu na definicję makra	64-bitowa	32-bitowa

Mapowania procedur tekstu ogólnego

Procedura tchar.h	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_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

Function	Wymagany nagłówek
_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>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Biblioteki

Wszystkie wersje bibliotek czasu wykonywania języka C.

Zobacz też

Wywołania systemowe
Funkcje wyszukiwania nazw plików