Méthode IStorage ::SetElementTimes (objidl.h)

La méthode SetElementTimes définit les heures de modification, d’accès et de création de l’élément de stockage spécifié, si le système de fichiers sous-jacent prend en charge cette méthode.

Syntaxe

HRESULT SetElementTimes(
  [in] const OLECHAR  *pwcsName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

Paramètres

[in] pwcsName

Nom de l’élément d’objet de stockage dont les heures doivent être modifiées. Si la valeur est NULL, l’heure est définie sur le stockage racine plutôt que sur l’un de ses éléments.

[in] pctime

Heure de création de l’élément ou NULL si l’heure de création ne doit pas être modifiée.

[in] patime

Nouvelle heure d’accès pour l’élément ou NULL si l’heure d’accès ne doit pas être modifiée.

[in] pmtime

Nouvelle heure de modification pour l’élément ou NULL si l’heure de modification ne doit pas être modifiée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK Les valeurs de temps ont été correctement définies.
E_PENDING Stockage asynchrone uniquement : une partie ou la totalité des données de l’élément sont actuellement indisponibles.
STG_E_ACCESSDENIED L’appelant ne dispose pas d’autorisations suffisantes pour modifier l’élément.
STG_E_FILENOTFOUND L’élément portant le nom spécifié n’existe pas.
STG_E_INSUFFICIENTMEMORY L’élément n’a pas été modifié en raison d’un manque de mémoire.
STG_E_INVALIDNAME Valeur non valide pour le nom de l’élément.
STG_E_INVALIDPOINTER Le pointeur spécifié pour l’élément n’était pas valide.
STG_E_INVALIDPARAMETER L’un des paramètres n’était pas valide.
STG_E_TOOMANYOPENFILES L’élément n’a pas été modifié, car il y a trop de fichiers ouverts.
STG_E_REVERTED L’objet de stockage a été invalidé par une opération de rétablissement au-dessus de lui dans l’arborescence des transactions.

Remarques

SetElementTimes définit les statistiques de temps pour l’élément de stockage spécifié dans cet objet de stockage.

Tous les systèmes de fichiers ne prennent pas en charge toutes les valeurs temporelles. Cette méthode définit les heures prises en charge et ignore le reste. Chaque paramètre time-value peut être NULL ; indiquant qu’aucune modification ne doit se produire.

Appelez la méthode IStorage ::Stat pour récupérer ces valeurs de temps.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête objidl.h
Bibliothèque Uuid.lib
DLL Ole32.dll

Voir aussi

IStorage - Implémentation de fichiers composés

IStorage ::Stat