Condividi tramite

Funzione FindFirstFileExFromAppW (fileapifromapp.h)

  • Articolo

Cerca una directory per un file o una sottodirectory con un nome e attributi corrispondenti a quelli specificati. Il comportamento di questa funzione è identico a FindFirstFileEx, ad eccezione del fatto che questa funzione rispetta il modello di sicurezza delle app piattaforma UWP (Universal Windows Platform).

Sintassi

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

Parametri

lpFileName

Directory o percorso e il nome del file. Il nome del file può includere caratteri jolly, ad esempio un asterisco (*) o un punto interrogativo (?).

Questo parametro non deve essere NULL, una stringa non valida(ad esempio, una stringa vuota o una stringa mancante del carattere Null di terminazione) o terminare in una barra rovesciata finale (\).

Se la stringa termina con un carattere jolly, un punto o un nome di directory, l'utente deve avere accesso alla radice e a tutte le sottodirectory nel percorso.

Per informazioni sul rifiuto esplicito della limitazione MAX_PATH senza pre sospeso "\\?\", vedere la sezione "Limitazione massima lunghezza percorso" di Denominazione di file, percorsi e spazi dei nomi per informazioni dettagliate.

fInfoLevelId

Livello di informazioni dei dati restituiti.

Questo parametro è uno dei valori di enumerazione FINDEX_INFO_LEVELS .

lpFindFileData

Puntatore al buffer che riceve i dati del file.

Il tipo di puntatore è determinato dal livello di informazioni specificate nel parametro fInfoLevelId .

fSearchOp

Tipo di filtro da eseguire diverso dalla corrispondenza con caratteri jolly.

Questo parametro è uno dei valori di enumerazione FINDEX_SEARCH_OPS .

lpSearchFilter

Puntatore ai criteri di ricerca se l'oggetto fSearchOp specificato richiede informazioni di ricerca strutturate.

In questo momento, nessuno dei valori fSearchOp supportati richiede informazioni di ricerca estese. Pertanto, questo puntatore deve essere NULL.

dwAdditionalFlags

Specifica flag aggiuntivi che controllano la ricerca.

Valore Significato
FIND_FIRST_EX_CASE_SENSITIVE 1

Le ricerche sono distinzione tra maiuscole e minuscole.
FIND_FIRST_EX_LARGE_FETCH 2

Usa un buffer più grande per le query di directory, che può aumentare le prestazioni dell'operazione di ricerca.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4

Limita i risultati ai file fisicamente presenti su disco. Questo flag è rilevante solo quando è presente un filtro di virtualizzazione file.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle di ricerca usato in una chiamata successiva a FindNextFile o FindClose e il parametro lpFindFileData contiene informazioni sul primo file o directory trovato.

Se la funzione ha esito negativo o non riesce a individuare i file dalla stringa di ricerca nel parametro lpFileName , il valore restituito è INVALID_HANDLE_VALUE e il contenuto di lpFindFileData è indeterminato. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Requisiti

Requisito Valore
Client minimo supportato Windows 10, versione 1803
Intestazione fileapifromapp.h