Funzione GetFileAttributesA (fileapi.h)

Articolo
06/02/2023

Recupera gli attributi del file system per un file o una directory specificati.

Per ottenere altre informazioni sull'attributo, usare la funzione GetFileAttributesEx .

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

Sintassi

DWORD GetFileAttributesA(
  [in] LPCSTR lpFileName
);

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, prependo "\\?\" al percorso. Per altre informazioni, vedere Denominazione di file, percorsi e spazi dei nomi.

Suggerimento

A partire da Windows 10, versione 1607, è possibile scegliere di rimuovere la limitazione MAX_PATH senza pre sospeso "\\?\". Per informazioni dettagliate, vedere la sezione "Limitazione massima lunghezza percorso" di nomi, nomi, percorsi e spazi dei nomi .

Valore restituito

Se la funzione ha esito positivo, il valore restituito contiene gli attributi del file o della directory specificati. Per un elenco di valori di attributo e relative descrizioni, vedere Costanti attributo file.

Se la funzione ha esito negativo, il valore restituito è INVALID_FILE_ATTRIBUTES. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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

Se si chiama GetFileAttributes per una condivisione di rete, la funzione ha esito negativo e GetLastError restituisce ERROR_BAD_NETPATH. È necessario specificare un percorso di una sottocartella in tale condivisione.

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

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	Sì
Failover trasparente SMB 3.0 (TFO)	Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO)	Sì
File system del volume condiviso del cluster (CsvFS)	Sì
File system resiliente (ReFS)	Sì

Comportamento di 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 fino al commit della transazione. Quindi, se un thread transazionato apre prima il file, tutti i thread successivi che tentano di modificare il file prima che la transazione venga eseguito il commit riceva una violazione di condivisione. Se un thread non transazionale modifica il file prima che il thread transazionato venga eseguito e il file sia ancora aperto quando la transazione tenta di aprirla, la transazione riceve l'errore ERROR_TRANSACTIONAL_CONFLICT.

Esempi

Per un esempio, vedere Recupero e modifica degli attributi di file.

Nota

L'intestazione fileapi.h definisce GetFileAttributes come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (includere Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll