_findnext, _wfindnext

Localize o nome do próximo, se houver, que corresponde a filespec argumento em uma telefonar anterior _findfirste em seguida, altere o fileinfo estrutura de Sumário da mesma forma.

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

Parâmetros

• handle
  Identificador de Pesquisar retornado por uma telefonar anterior a _findfirst.

• fileinfo
  Buffer de informações do arquivo.

Valor de retorno

Se for bem-sucedida, retornará 0.Caso contrário, retorna – 1 e define errno para um valor que indica a natureza da falha. Códigos de erro possíveis são mostrados na tabela a seguir.

• EINVAL
  Parâmetro inválido: fileinfo foi NULL. Ou, o sistema operacional retornou um erro inesperado.

• ENOENT
  Não há mais arquivos coincidentes foi encontrados.

• ENOMEM
  Não há memória suficiente ou o comprimento do nome de arquivo excedido MAX_PATH.

Se um parâmetro inválido for passado, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.

Comentários

Você deve chamar _findclose depois você tiver terminado de usar ambos o _findfirst ou _findnext função (ou quaisquer variantes). Isso libera recursos usados por essas funções em seu aplicativo.

As variações dessas funções com o w prefixo são versões de caractere largo; caso contrário, elas são idênticas às funções correspondentes do byte único.

Variações dessas funções oferecem suporte a tipos de time de 32 bit ou 64 bit e tamanhos dos arquivos de 32 bit ou 64 bit.O primeiro sufixo numérico (32 ou 64) indica o dimensionar do time tipo usado; o segundo sufixo é i32 ou i64, que indica se o dimensionar do arquivo é representado sistema autônomo um inteiro de 32 bit ou 64 bit. Para obter informações sobre quais versões oferecem suporte time de 32 bit e 64 bit tipos e tamanhos de arquivo, consulte a tabela a seguir.As variações que usam um tipo de time de 64 bit que datas de criação do arquivo a ser expressa até a 23: 59: 59, 31 de dezembro de 3000, UTC; enquanto os que usam tipos de time de 32 bit somente representam datas até 19: 14: 07 18 º de janeiro de 2038, UTC.Meia-noite, 1 º de janeiro de 1970, é o limite inferior do intervalo de datas para todas essas funções.

A menos que você tenha um motivo específico para usar as versões que especificar explicitamente o dimensionar do time, use _findnext ou _wfindnext ou, se você precisar oferecer suporte a tamanhos de arquivo maiores que 3 GB, use _findnexti64 ou _wfindnexti64. Todas essas funções usam o tipo de time de 64 bit em Visual C++ 2005. Em versões anteriores, essas funções usadas um tipo de time de 32 bit.Se esta for uma alterar significativa para um aplicativo, você pode definir _USE_32BIT_TIME_T Para obter o comportamento antigo. If _USE_32BIT_TIME_T é definido, _findnext, _finnexti64 e suas versões correspondentes do Unicode usam um time de 32 bit.

Tipo de time e arquivo length tipo variações de _findnext

Mapeamentos de rotina de texto genérica

Requisitos

Para obter mais informações de compatibilidade, consulte Compatibilidade na introdução.

Bibliotecas

Todas as versões do C em time de execução bibliotecas.

Equivalente do NET Framework

Não aplicável. Para telefonar a função C padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Chamadas do sistema

_find, _wfind funções