Função FindFirstFileNameW (fileapi.h)

Cria uma enumeração de todos os links físicos para o arquivo especificado. A função FindFirstFileNameW retorna um identificador para a enumeração que pode ser usada em chamadas subsequentes para a função FindNextFileNameW.

Para executar essa operação como uma operação transacionada, use a função FindFirstFileNameTransactedW .

Sintaxe

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parâmetros

[in] lpFileName

O nome do arquivo.

Ponta A partir do Windows 10, versão 1607, você pode optar por remover a limitação de MAX_PATH sem acrescentar "\\?\". Consulte a seção "Limitação máxima do comprimento do caminho" de Arquivos de Nomenclatura, Caminhos e Namespaces para obter detalhes.

 

[in] dwFlags

Reservados; especifique zero (0).

[in, out] StringLength

O tamanho do buffer apontado pelo parâmetro LinkName , em caracteres. Se essa chamada falhar e o erro retornado da função GetLastError for ERROR_MORE_DATA (234), o valor retornado por esse parâmetro será o tamanho para o qual o buffer apontado por LinkName deverá conter todos os dados.

[in, out] LinkName

Um ponteiro para um buffer para armazenar o nome do primeiro link encontrado para lpFileName.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador de pesquisa que pode ser usado com a função FindNextFileNameW ou fechado com a função FindClose .

Se a função falhar, o valor retornado será INVALID_HANDLE_VALUE (0xffffffff). Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Tecnologia	Com suporte
Protocolo SMB (SMB) 3.0	Sim
TFO (Failover transparente) do SMB 3.0	No
SMB 3.0 com compartilhamentos de arquivos de expansão (SO)	No
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS)	Sim
ReFS (Sistema de Arquivos Resiliente)	Sim

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	fileapi.h (inclua Windows.h, WinBase.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW