SFGAO

SFGAO I valori di bitfield rappresentano attributi che possono essere recuperati in un elemento (file o cartella) o in un set di elementi. Vengono usati con le API IShellFolder e IShellItem, in particolare IShellFolder::GetAttributesOf e IShellItem::GetAttributes.

Costante/valore Descrizione
SFGAO_CANCOPY
0x00000001
Gli elementi specificati possono essere copiati.
SFGAO_CANMOVE
0x00000002
Gli elementi specificati possono essere spostati.
SFGAO_CANLINK
0x00000004
È possibile creare collegamenti per gli elementi specificati. Questo attributo ha lo stesso valore di DROPEFFECT_LINK.
Se un'estensione dello spazio dei nomi restituisce questo attributo, viene aggiunta una voce Crea collegamento con un gestore predefinito al menu di scelta rapida visualizzato durante le operazioni di trascinamento della selezione. L'estensione può anche implementare il proprio gestore per il verbo di collegamento al posto dell'impostazione predefinita. Se l'estensione esegue questa operazione, è responsabile della creazione del collegamento.
Viene aggiunta anche una voce Crea collegamento al menu File di Esplora risorse e ai normali menu di scelta rapida.
Se l'elemento è selezionato, il metodo IContextMenu::InvokeCommand dell'applicazione viene richiamato con il membro lpVerb della struttura CMINVOKECOMMANDINFO impostata per il collegamento. L'applicazione è responsabile della creazione del collegamento.
SFGAO_STORAGE
0x00000008
Gli elementi specificati possono essere associati a un oggetto IStorage tramite IShellFolder::BindToObject. Per altre informazioni sulle funzionalità di manipolazione dello spazio dei nomi, vedere IStorage.
SFGAO_CANRENAME
0x00000010
Gli elementi specificati possono essere rinominati. Si noti che questo valore è essenzialmente un suggerimento; non tutti i client dello spazio dei nomi consentono di rinominare gli elementi. Tuttavia, quelli che devono avere questo attributo impostato.
SFGAO_CANDELETE
0x00000020
Gli elementi specificati possono essere eliminati.
SFGAO_HASPROPSHEET
0x00000040
Gli elementi specificati dispongono di finestre delle proprietà.
SFGAO_DROPTARGET
0x00000100
Gli elementi specificati sono destinazioni di rilascio.
SFGAO_CAPABILITYMASK
0x00000177
Questo flag è una maschera per gli attributi di funzionalità: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET e SFGAO_DROPTARGET. I chiamanti in genere non usano questo valore.
SFGAO_SYSTEM
0x00001000
Windows 7 e versioni successive. Gli elementi specificati sono elementi di sistema.
SFGAO_ENCRYPTED
0x00002000
Gli elementi specificati sono crittografati e potrebbero richiedere una presentazione speciale.
SFGAO_ISSLOW
0x00004000
L'accesso all'elemento (tramite IStream o altre interfacce di archiviazione) dovrebbe essere un'operazione lenta. Le applicazioni devono evitare di accedere agli elementi contrassegnati con SFGAO_ISSLOW.
Nota: L'apertura di un flusso per un elemento è in genere un'operazione lenta in qualsiasi momento. SFGAO_ISSLOW indica che dovrebbe essere particolarmente lento, ad esempio in caso di connessioni di rete lente o file offline (FILE_ATTRIBUTE_OFFLINE). Tuttavia, l'esecuzione di query SFGAO_ISSLOW è un'operazione lenta. Le applicazioni devono eseguire query SFGAO_ISSLOW solo su un thread in background. È possibile usare un metodo alternativo, ad esempio il recupero della proprietà PKEY_FileAttributes e il test per FILE_ATTRIBUTE_OFFLINE, al posto di una chiamata al metodo che coinvolge SFGAO_ISSLOW.
SFGAO_GHOSTED
0x00008000
Gli elementi specificati vengono visualizzati come disattivati e non disponibili per l'utente.
SFGAO_LINK
0x00010000
Gli elementi specificati sono collegamenti.
SFGAO_SHARE
0x00020000
Gli oggetti specificati sono condivisi.
SFGAO_READONLY
0x00040000
Gli elementi specificati sono di sola lettura. Nel caso delle cartelle, ciò significa che non è possibile creare nuovi elementi in tali cartelle. Questo comportamento non deve essere confuso con il comportamento specificato dal flag FILE_ATTRIBUTE_READONLY recuperato da IColumnProvider::GetItemData in una struttura SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY non ha alcun significato per le cartelle del file system Win32.
SFGAO_HIDDEN
0x00080000
L'elemento è nascosto e non deve essere visualizzato a meno che l'opzione Mostra file e cartelle nascosti non sia abilitata in Impostazioni cartella.
SFGAO_DISPLAYATTRMASK
0x000FC000
Non usare.
SFGAO_NONENUMERATED
0x00100000
Gli elementi sono elementi non numerati e devono essere nascosti. Non vengono restituiti tramite un enumeratore, ad esempio quello creato dal metodo IShellFolder::EnumObjects .
SFGAO_NEWCONTENT
0x00200000
Gli elementi contengono nuovo contenuto, come definito dall'applicazione specifica.
SFGAO_CANMONIKER
Non supportato.
SFGAO_HASSTORAGE
Non supportato.
SFGAO_STREAM
0x00400000
Indica che all'elemento è associato un flusso. È possibile accedere a tale flusso tramite una chiamata a IShellFolder::BindToObject o IShellItem::BindToHandler con IID_IStream nel parametro riid .
SFGAO_STORAGEANCESTOR
0x00800000
Gli elementi figlio di questo elemento sono accessibili tramite IStream o IStorage. Tali figli vengono contrassegnati con SFGAO_STORAGE o SFGAO_STREAM.
SFGAO_VALIDATE
0x01000000
Se specificato come input, SFGAO_VALIDATE indica alla cartella di convalidare che gli elementi contenuti in una cartella o in una matrice di elementi shell esistano. Se uno o più di questi elementi non esistono, IShellFolder::GetAttributesOf e IShellItemArray::GetAttributes restituiscono un codice di errore. Questo flag non viene mai restituito come valore [out].
Se usato con la cartella del file system, SFGAO_VALIDATE indica alla cartella di eliminare le proprietà memorizzate nella cache recuperate dai client di IShellFolder2::GetDetailsEx che potrebbero aver accumulato per gli elementi specificati.
SFGAO_REMOVABLE
0x02000000
Gli elementi specificati si trovano su supporti rimovibili o si trovano dispositivi rimovibili.
SFGAO_COMPRESSED
0x04000000
Gli elementi specificati vengono compressi.
SFGAO_BROWSABLE
0x08000000
Gli elementi specificati possono essere ospitati all'interno di un web browser o di un frame di Esplora risorse.
SFGAO_FILESYSANCESTOR
0x10000000
Le cartelle specificate sono cartelle di file system o contengono almeno un discendente (figlio, nipote o versione successiva) che è una cartella del file system (SFGAO_FILESYSTEM).
SFGAO_FOLDER
0x20000000
Gli elementi specificati sono cartelle. Alcuni elementi possono essere contrassegnati con SFGAO_STREAM e SFGAO_FOLDER, ad esempio un file compresso con un'estensione .zip nome file. Alcune applicazioni possono includere questo flag durante il test per gli elementi che sono sia file che contenitori.
SFGAO_FILESYSTEM
0x40000000
Le cartelle o i file specificati fanno parte del file system, ovvero sono file, directory o directory radice. I nomi analizzati degli elementi possono essere considerati percorsi validi del file system Win32. Questi percorsi possono essere basati su unC o su unità.
SFGAO_STORAGECAPMASK
0x70C50008
Questo flag è una maschera per gli attributi delle funzionalità di archiviazione: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER e SFGAO_FILESYSTEM. I chiamanti normalmente non usano questo valore.
SFGAO_HASSUBFOLDER
0x80000000
Le cartelle specificate hanno sottocartelle. L'attributo SFGAO_HASSUBFOLDER è solo avviso e potrebbe essere restituito dalle implementazioni della cartella shell anche se non contengono sottocartelle. Si noti, tuttavia, che il contrario, non riesce a restituire SFGAO_HASSUBFOLDER, indica definitivamente che gli oggetti della cartella non dispongono di sottocartelle.
La restituzione di SFGAO_HASSUBFOLDER è consigliata ogni volta che è necessario un periodo di tempo significativo per determinare se esistono sottocartelle. Ad esempio, Shell restituisce sempre SFGAO_HASSUBFOLDER quando una cartella si trova in un'unità di rete.
SFGAO_CONTENTSMASK
0x80000000
Questo flag è una maschera per gli attributi del contenuto, attualmente solo SFGAO_HASSUBFOLDER. I chiamanti normalmente non usano questo valore.
SFGAO_PKEYSFGAOMASK
0x81044000
Maschera usata dalla proprietà PKEY_SFGAOFlags per determinare gli attributi considerati per causare calcoli lente o mancanza di contesto: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER e SFGAO_VALIDATE. I chiamanti normalmente non usano questo valore.

Requisiti

Requisito valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
Shobjidl.h
IDL
Shobjidl.idl

Vedi anche

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

IShellItem::GetAttributes

IShellItemArray::GetAttributes