Windows Win32Arquivos & E/Skernel32.dll
FindFirstFileW
Inicia uma busca por arquivos/diretórios que correspondam a um padrão de nome, retornando o primeiro resultado.
Descrição
Base da enumeração de diretórios na Win32 API — diferente do Linux (onde `open`+`getdents64` faz isso), o Windows expõe diretamente uma API de busca por padrão (glob).
Header:
fileapi.hDLL: kernel32.dllNative API: NtQueryDirectoryFileNota
Equivalente conceitual a abrir um diretório e chamar `getdents64` no Linux, embutindo o filtro de padrão diretamente na API.
Assinatura
HANDLE FindFirstFileW(LPCWSTR lpFileName, LPWIN32_FIND_DATAW lpFindFileData);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| lpFileName | LPCWSTR | Caminho ou padrão de busca (aceita curingas * e ?). |
| lpFindFileData | LPWIN32_FIND_DATAW | Recebe os metadados do primeiro arquivo encontrado. |
Valor de retorno
Um handle de busca em sucesso; INVALID_HANDLE_VALUE se nada corresponder ou em erro.
Códigos de erro (GetLastError)
- ERROR_FILE_NOT_FOUND(2)
- O sistema não conseguiu encontrar o arquivo especificado.
- ERROR_PATH_NOT_FOUND(3)
- O sistema não conseguiu encontrar o caminho especificado.