implémentation du système de fichiers IPropertyStorage-NTFS
La version NTFS 5.0 fournit une implémentation de l’interface IPropertyStorage pour les fichiers sur un volume NTFS lorsque les fichiers ne sont pas des fichiers composés.
Pour obtenir un pointeur vers l’implémentation du système de fichiers NTFS d’IPropertySetStorage
- Appelez IPropertySetStorage ::Create à l’aide de l’implémentation NTFS de IPropertySetStorage.
- Appelez IPropertySetStorage ::Open à l’aide de l’implémentation NTFS de IPropertySetStorage.
Quand utiliser
Utilisez IPropertyStorage pour gérer les propriétés au sein d’un jeu de propriétés unique. Ses méthodes prennent en charge la lecture, l’écriture et la suppression de propriétés et les noms de chaîne facultatifs qui peuvent être associés à des identificateurs de propriété. Une autre méthode vous permet de définir des heures associées au stockage de propriétés, et une autre permet l’affectation d’un CLSID, utilisé pour associer d’autres codes, tels que du code d’interface utilisateur (UI), à l’ensemble de propriétés. L’appel de la méthode Enumfournit un pointeur vers l’implémentation NTFS de IEnumSTATPROPSTG, ce qui vous permet d’énumérer les propriétés dans l’ensemble.
Remarques
L’implémentation NTFS fournit essentiellement les mêmes fonctionnalités que l’implémentation de fichier composé. Pour plus d’informations, consultez IPropertyStorage-Compoundimplémentation de fichiers .
Étant donné que NTFS est un système de fichiers robuste, un jeu de propriétés NTFS ne sera jamais laissé dans un état incorrect. Lorsque le contenu d’un fichier NTFS IPropertyStorage est vidé sur le fichier NTFS sous-jacent, l’état est écrit ou non dans le fichier en tant qu’opération atomique, même s’il y a un échec pendant l’opération, comme une terminaison de processus anormale. Pour obtenir un comportement similaire avec l’implémentation de fichier composé, l’interface parente IPropertySetStorage doit être ouverte en mode transaction.
Ce niveau de robustesse est possible uniquement lors de l’accès à une propriété NTFS définie sur un volume NTFS 5.0. Il est possible d’accéder aux ensembles de propriétés NTFS sur des versions antérieures de NTFS (par exemple, un ordinateur s’exécutant sur Windows NT ou Windows 2000 qui accède aux jeux de propriétés sur un ordinateur serveur de fichiers s’exécutant sur Windows NT 4.0), mais ils ne sont pas garantis comme étant dans un état correct en cas d’échec inattendu.
Bien que l’implémentation NTFS de IPropertySetStorage ne prenne pas en charge la transaction, l’implémentation NTFS de IPropertyStorage la prend en charge. Autrement dit, STGM_TRANSACTED peuvent être spécifiées dans le paramètre grfMode aux méthodes Create et Open de IPropertySetStorage. Comme dans l’implémentation de fichier composé, le mode transactionné est possible uniquement pour les stockages de propriétés non simples (en spécifiant PROPSETFLAG_NONSIMPLE dans le paramètre grfFlags).
Rubriques connexes
-
IPropertySetStorage-NTFS d’implémentation du système de fichiers