IStorage::SetElementTimes-Methode (objidl.h)

  • Artikel

Die SetElementTimes-Methode legt die Änderungs-, Zugriffs- und Erstellungszeiten des angegebenen Speicherelements fest, wenn das zugrunde liegende Dateisystem diese Methode unterstützt.

Syntax

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

Parameter

[in] pwcsName

Der Name des Speicherobjektelements, dessen Zeiten geändert werden sollen. Wenn NULL, wird die Zeit für den Stammspeicher und nicht für eines seiner Elemente festgelegt.

[in] pctime

Entweder die neue Erstellungszeit für das Element oder NULL , wenn die Erstellungszeit nicht geändert werden soll.

[in] patime

Entweder die neue Zugriffszeit für das Element oder NULL , wenn die Zugriffszeit nicht geändert werden soll.

[in] pmtime

Entweder die neue Änderungszeit für das Element oder NULL , wenn die Änderungszeit nicht geändert werden soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK Die Zeitwerte wurden erfolgreich festgelegt.
E_PENDING Nur asynchroner Speicher: Ein Teil oder alle Daten des Elements sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED Der Aufrufer verfügt nicht über genügend Berechtigungen zum Ändern des Elements.
STG_E_FILENOTFOUND Das Element mit dem angegebenen Namen ist nicht vorhanden.
STG_E_INSUFFICIENTMEMORY Das Element wurde aufgrund eines Mangels an Arbeitsspeicher nicht geändert.
STG_E_INVALIDNAME Kein gültiger Wert für den Elementnamen.
STG_E_INVALIDPOINTER Der für das Element angegebene Zeiger war ungültig.
STG_E_INVALIDPARAMETER Einer der Parameter war ungültig.
STG_E_TOOMANYOPENFILES Das Element wurde nicht geändert, weil zu viele dateien geöffnet sind.
STG_E_REVERTED Das Speicherobjekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.

Hinweise

SetElementTimes legt Zeitstatistiken für das angegebene Speicherelement in diesem Speicherobjekt fest.

Nicht alle Dateisysteme unterstützen alle Zeitwerte. Diese Methode legt die unterstützten Zeiten fest und ignoriert den Rest. Jeder Zeitwertparameter kann NULL sein. Gibt an, dass keine Änderung erfolgen soll.

Rufen Sie die IStorage::Stat-Methode auf, um diese Zeitwerte abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h
Bibliothek Uuid.lib
DLL Ole32.dll

Weitere Informationen

IStorage – Implementierung von Zusammengesetzten Dateien

IStorage::Stat