FindFirstFileEx

9/8/2008

Essa função procura um Diretório para um arquivo com o nome especificado e atributos.

Syntax

HANDLE FindFirstFileEx(
  LPCTSTR lpFileName, 
  FINDEX_INFO_LEVELS fInfoLevelId, 
  LPVOID lpFindFileData, 
  FINDEX_SEARCH_OPS fSearchOp, 
  LPVOID lpSearchFilter, 
  DWORD dwAdditionalFlags 
);

Parameters

• lpFileName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica um válido nome Diretório ou caminho e arquivo, que pode conter caracteres curinga, como um asterisco (*) ou um ponto de interrogação (?).

• fInfoLevelId
  [no] FINDEX_INFO_LEVELS enumeração tipo que especifica as informações nível dos dados retornados.

• lpFindFileData
  [out] Ponteiro para uma estrutura WIN32_FIND_DATA.

• fSearchOp
  [no] FINDEX_SEARCH_OPS enumeração tipo que especifica o tipo de filtragem para executar além curinga compatível.

• lpSearchFilter
  [no] Ponteiro que deve ser definido como NULL.

• dwAdditionalFlags
  [no] Sem suporte. Definido como zero.

Return Value

Um identificador pesquisa que pode ser usado em um chamar subseqüente para o FindNextFile ou as funções FindClose indica sucesso. INVALID_HANDLE_VALUE indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função abrirá um identificador pesquisa para obter informações sobre o primeiro arquivo com o nome especificado e atributos. Pesquisas nome de arquivo não são com diferenciação de maiúsculas e minúsculas.

Se o subjacente sistema de arquivos não suporte o especificado tipo de filtragem diferente filtragem Diretório, esta função falha e retorna ERROR_NOT_SUPPORTED. O aplicativo deve usar o FileExSearchNameMatch tipo in a FINDEX_SEARCH_OPS estrutura e executar sua própria filtragem.

Depois de estabelecidas, identificador de pesquisa pode ser usado em FindNextFile a pesquisa para outros arquivos que correspondam ao mesmo nome e atributos com a mesma filtragem sendo executada. Quando o identificador pesquisa não for necessário, fechá-lo usando o FindClose função.

O seguinte são chamadas para esta função e FindFirstFile equivalente.

FindFirstFileEx(lpFileName, FindExInfoStandard, lpFindData, FindExSearchNameMatch, NULL, 0);
FindFirstFile(lpFileName, lpFindData);

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
FindClose
FindFirstFile
FindNextFile
FINDEX_INFO_LEVELS
FINDEX_SEARCH_OPS
WIN32_FIND_DATA