Condividi tramite


implementazione IPropertyStorage-NTFS file system

La versione NTFS 5.0 fornisce un'implementazione dell'interfacciaIPropertyStorage per i file in un volume NTFS quando i file non sono file composti.

Per ottenere un puntatore all'implementazione del file system NTFS di IPropertySetStorage

  1. Chiamare IPropertySetStorage::Create usando l'implementazione NTFS di IPropertySetStorage.
  2. Chiamare IPropertySetStorage::Open usando l'implementazione NTFS di IPropertySetStorage.

Quando usare

Usare IPropertyStorage per gestire le proprietà all'interno di un singolo set di proprietà. I metodi supportano la lettura, la scrittura e l'eliminazione di proprietà e i nomi di stringa facoltativi che possono essere associati agli identificatori di proprietà. Un altro metodo consente di impostare i tempi associati all'archiviazione delle proprietà e un altro consente l'assegnazione di un CLSID, usato per associare altro codice, ad esempio il codice dell'interfaccia utente, al set di proprietà. La chiamata al metodoEnumfornisce un puntatore all'implementazione NTFS di IEnumSTATPROPSTG, che consente di enumerare le proprietà nel set.

Osservazioni

L'implementazione NTFS fornisce essenzialmente le stesse funzionalità dell'implementazione del file composto. Per altre informazioni, vedere IPropertyStorage-Compound'implementazione di file.

Poiché NTFS è un file system affidabile, un set di proprietà NTFS non verrà mai lasciato in uno stato errato. Quando il contenuto di un NTFS IPropertyStorage viene scaricato nel file NTFS sottostante, tutti o nessuno dello stato viene scritto nel file come operazione atomica, anche se si verifica un errore durante l'operazione, ad esempio una terminazione anomala del processo. Per ottenere un comportamento simile con l'implementazione del file composto, l'interfaccia padre IPropertySetStorage deve essere aperta in modalità transazionale.

Questo livello di affidabilità è possibile solo quando si accede a una proprietà NTFS impostata su un volume NTFS 5.0. È possibile accedere ai set di proprietà NTFS nelle versioni precedenti di NTFS (ad esempio, un computer in esecuzione in Windows NT o Windows 2000 che accede ai set di proprietà in un computer file server in esecuzione in Windows NT 4.0), ma non è garantito che siano in uno stato corretto in caso di errore imprevisto.

Sebbene l'implementazione NTFS di IPropertySetStorage non supporti la transazione, l'implementazione NTFS di IPropertyStorage la supporta. Ciò significa che è possibile specificare STGM_TRANSACTED nel parametro grfMode per i metodi Create e Open di IPropertySetStorage. Come nell'implementazione del file composto, la modalità transacted è possibile solo per le risorse di archiviazione delle proprietà nonsimple (specificando PROPSETFLAG_NONSIMPLE nel parametro grfFlags).

IPropertyStorage

IPropertySetStorage-NTFS'implementazione del file system