Funzione GetFileAttributesExW (fileapi.h)

Articolo
11/20/2024

Recupera gli attributi per un file o una directory specificata.

Per eseguire questa operazione come operazione transazionata, usare la funzione getFileAttributesTransacted .

Sintassi

BOOL GetFileAttributesExW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation
);

Parametri

[in] lpFileName

Nome del file o della directory.

Per impostazione predefinita, il nome è limitato a MAX_PATH caratteri. Per estendere questo limite a 32.767 caratteri wide, anteporre "\\?\" al percorso. Per altre informazioni, vedere denominazione di file, percorsi e spazi dei nomi.

Mancia

A partire da Windows 10, versione 1607, è possibile acconsentire esplicitamente alla rimozione della limitazione MAX_PATH senza anteporre "\\?\". Per informazioni dettagliate, vedere la sezione "Limitazione massima della lunghezza del percorso" di nomi, percorsi e spazi dei nomi.

[in] fInfoLevelId

Classe di informazioni sugli attributi da recuperare.

Questo parametro può essere il valore seguente dell'enumerazione GET_FILEEX_INFO_LEVELS.

Valore	Significato
GetFileExInfoStandard	Il parametro lpFileInformation è una struttura WIN32_FILE_ATTRIBUTE_DATA.

[out] lpFileInformation

Puntatore a un buffer che riceve le informazioni sull'attributo.

Il tipo di informazioni sull'attributo archiviato in questo buffer è determinato dal valore di fInfoLevelId.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione GetFileAttributes recupera le informazioni sull'attributo del file system. GetFileAttributesEx può ottenere altri set di informazioni sull'attributo di file o directory. Attualmente, GetFileAttributesEx recupera un set di attributi standard che è un superset delle informazioni sull'attributo del file system.

Quando la funzione GetFileAttributesEx viene chiamata in una directory che è una cartella montata, restituisce gli attributi della directory, non quelli della directory radice nel volume associato alla directory montata. Per ottenere gli attributi del volume associato, chiamare GetVolumeNameForVolumeMountPoint per ottenere il nome del volume associato. Usare quindi il nome risultante in una chiamata a GetFileAttributesEx. I risultati sono gli attributi della directory radice nel volume associato.

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia	Sostenuto
Protocollo SMB (Server Message Block) 3.0	Sì
SMB 3.0 Transparent Failover (TFO)	Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	Sì
Cluster Shared Volume File System (CsvFS)	Sì
Resilient File System (ReFS)	Sì

Comportamento del collegamento simbolico: se il percorso punta a un collegamento simbolico, la funzione restituisce attributi per il collegamento simbolico.

operazioni transazionate

Se un file è aperto per la modifica in una transazione, nessun altro thread può aprire il file per la modifica finché non viene eseguito il commit della transazione. Pertanto, se un thread transazionale apre prima il file, tutti i thread successivi che tentano di modificare il file prima che venga eseguito il commit della transazione ricevano una violazione di condivisione. Se un thread non transazionale modifica il file prima che il thread transazionale e il file sia ancora aperto quando la transazione tenta di aprirlo, la transazione riceve l'errore ERROR_TRANSACTIONAL_CONFLICT.

Nota

L'intestazione fileapi.h definisce GetFileAttributesEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	fileapi.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll