Compartilhar via


Função FindFirstFileExFromAppW (fileapifromapp.h)

Em um diretório, pesquisa um arquivo ou subdiretório com um nome e atributos que correspondam aos especificados. O comportamento dessa função é idêntico a FindFirstFileEx, exceto que essa função segue o modelo de segurança do aplicativo Plataforma Universal do Windows.

Sintaxe

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

Parâmetros

lpFileName

O diretório ou caminho e o nome do arquivo. O nome do arquivo pode incluir caracteres curinga, por exemplo, um asterisco (*) ou um ponto de interrogação (?).

Esse parâmetro não deve ser NULL, uma cadeia de caracteres inválida (por exemplo, uma cadeia de caracteres vazia ou uma cadeia de caracteres que não tem o caractere nulo de terminação) ou terminar em uma barra invertida à direita (\).

Se a cadeia de caracteres terminar com um curinga, ponto ou nome de diretório, o usuário deverá ter acesso à raiz e a todos os subdiretórios no caminho.

Para obter informações sobre como recusar a limitação de MAX_PATH sem acrescentar "\\?\", consulte a seção "Limitação máxima do comprimento do caminho" de Nomear arquivos, caminhos e namespaces para obter detalhes.

fInfoLevelId

O nível de informações dos dados retornados.

Esse parâmetro é um dos valores de enumeração FINDEX_INFO_LEVELS .

lpFindFileData

Um ponteiro para o buffer que recebe os dados do arquivo.

O tipo de ponteiro é determinado pelo nível de informações especificado no parâmetro fInfoLevelId .

fSearchOp

O tipo de filtragem a ser executada que é diferente da correspondência curinga.

Esse parâmetro é um dos valores de enumeração FINDEX_SEARCH_OPS .

lpSearchFilter

Um ponteiro para os critérios de pesquisa se o fSearchOp especificado precisar de informações de pesquisa estruturadas.

No momento, nenhum dos valores fSearchOp com suporte exige informações de pesquisa estendidas. Portanto, esse ponteiro deve ser NULL.

dwAdditionalFlags

Especifica sinalizadores adicionais que controlam a pesquisa.

Valor Significado
FIND_FIRST_EX_CASE_SENSITIVE 1

As pesquisas diferenciam maiúsculas de minúsculas.

FIND_FIRST_EX_LARGE_FETCH 2

Usa um buffer maior para consultas de diretório, o que pode aumentar o desempenho da operação de localização.

FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4

Limita os resultados a arquivos fisicamente em disco. Esse sinalizador só é relevante quando um filtro de virtualização de arquivo está presente.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador de pesquisa usado em uma chamada subsequente para FindNextFile ou FindClose, e o parâmetro lpFindFileData conterá informações sobre o primeiro arquivo ou diretório encontrado.

Se a função falhar ou falhar ao localizar arquivos da cadeia de caracteres de pesquisa no parâmetro lpFileName , o valor retornado será INVALID_HANDLE_VALUE e o conteúdo de lpFindFileData será indeterminado. Para obter informações de erro estendidas, chame a função GetLastError.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1803
Cabeçalho fileapifromapp.h