FindFirstFile

9/8/2008

Essa função procura um Diretório de um arquivo ou subdiretório com nome de arquivo especificado.

Uma versão RAPI dessa função existe chamado CeFindFirstFile (RAPI).

Syntax

HANDLE FindFirstFile(
  LPCTSTR lpFileName, 
  LPWIN32_FIND_DATA lpFindFileData 
); 

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 (?).

  O limite tamanho seqüência de caracteres usar como padrão de caminhos é caracteres MAX_PATH. Esse limite é relacionado ao como Esta função analisa os caminhos.

• lpFindFileData
  [out] Ponteiro para a estrutura WIN32_FIND_DATA que recebe informações sobre o arquivo encontrado ou subdiretório.

Return Value

Um identificador pesquisa, usado em um chamar subseqüente para o FindNextFile ou a função 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 e retorna informações sobre o primeiro arquivo com o nome especificado. Depois que o identificador pesquisa for estabelecida, usar essa função para pesquisa para outros arquivos que correspondem a padrão. Quando o identificador pesquisa não for necessário, fechá-lo com FindClose.

Essa função procura por arquivos somente pelo nome. Ele não pode ser usado para pesquisas com base em atributos.

Requirements

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

See Also

Reference

File I/O Functions
FindClose
FindNextFile
GetFileAttributes
WIN32_FIND_DATA
FindFirstFileEx