Funzione SetFileAttributesFromAppW (fileapifromapp.h)

Imposta gli attributi per un file o una directory. Il comportamento di questa funzione è identico a SetFileAttributes, ad eccezione del fatto che questa funzione rispetta il modello di sicurezza delle app piattaforma UWP (Universal Windows Platform).

Sintassi

WINSTORAGEAPI BOOL SetFileAttributesFromAppW(
  LPCWSTR lpFileName,
  DWORD   dwFileAttributes
) noexcept;

Parametri

lpFileName

Nome del file i cui attributi devono essere impostati.

Per informazioni su come rifiutare esplicitamente la limitazione MAX_PATH senza anteporre "\\?\", vedere la sezione "Limitazione massima della lunghezza del percorso" di Denominazione di file, percorsi e spazi dei nomi per informazioni dettagliate.

dwFileAttributes

Attributi del file da impostare per il file.

Questo parametro può essere uno o più valori, combinati usando l'operatore OR bit per bit. Tuttavia, tutti gli altri valori eseguono l'override FILE_ATTRIBUTE_NORMAL.

Non tutti gli attributi sono supportati da questa funzione.

Di seguito è riportato un elenco di valori di attributo supportati.

Valore	Significato
FILE_ATTRIBUTE_ARCHIVE 32 (0x20)	Un file o una directory che è un file o una directory di archiviazione. Le applicazioni usano in genere questo attributo per contrassegnare i file per il backup o la rimozione.
FILE_ATTRIBUTE_HIDDEN 2 (0x2)	Il file o la directory è nascosta. Non è incluso in un elenco di directory normale.
FILE_ATTRIBUTE_NORMAL 128 (0x80)	File che non dispone di altri attributi impostati. Questo attributo è valido solo se usato da solo.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 8192 (0x2000)	Il file o la directory non deve essere indicizzato dal servizio di indicizzazione del contenuto.
FILE_ATTRIBUTE_OFFLINE 4096 (0x1000)	I dati di un file non sono immediatamente disponibili. Questo attributo indica che i dati del file vengono spostati fisicamente nell'archiviazione offline. Questo attributo viene usato da Archiviazione remota, ovvero il software di gestione dell'archiviazione gerarchica. Le applicazioni non devono modificare arbitrariamente questo attributo.
FILE_ATTRIBUTE_READONLY 1 (0x1)	File di sola lettura. Le applicazioni possono leggere il file, ma non possono scrivervi o eliminarle. Questo attributo non viene rispettato nelle directory.
FILE_ATTRIBUTE_SYSTEM 4 (0x4)	Un file o una directory utilizzata dal sistema operativo in modo esclusivo.
FILE_ATTRIBUTE_TEMPORARY 256 (0x100)	File utilizzato per l'archiviazione temporanea. I file system evitano di scrivere nuovamente i dati nell'archiviazione di massa se è disponibile memoria cache sufficiente, perché in genere un'applicazione elimina un file temporaneo dopo la chiusura dell'handle. In questo scenario, il sistema può evitare completamente di scrivere i dati. In caso contrario, i dati sono scritti dopo la chiusura dell'handle.

Valore restituito

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

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

Requisiti

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