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 |