Implementazione del file system IPropertyStorage-NTFS

La versione NTFS 5.0 fornisce un'implementazione dell'interfaccia IPropertyStorage 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.

Utilizzo

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 metodo Enum fornisce un puntatore all'implementazione NTFS di IEnumSTATPROPSTG, che consente di enumerare le proprietà nel set.

Commenti

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

Poiché NTFS è un file system affidabile, un set di proprietà NTFS non verrà mai lasciato in uno stato non corretto. Quando il contenuto di un file 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 del processo anormale. Per ottenere un comportamento simile con l'implementazione del file composto, l'interfaccia IPropertySetStorage padre deve essere aperta in modalità transacted.

Questo livello di robustezza è 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.

Anche se l'implementazione NTFS di IPropertySetStorage non supporta la transazione, l'implementazione NTFS di IPropertyStorage la supporta. Ovvero, STGM_TRANSACTED può essere specificato nel parametro grfMode ai metodi Create and Open di IPropertySetStorage. Come nell'implementazione del file composto, la modalità transazionata è possibile solo per le risorse di archiviazione delle proprietà nonsimple (specificando PROPSETFLAG_NONSIMPLE nel parametro grfFlags ).

IPropertyStorage

Implementazione del file system IPropertySetStorage-NTFS