IStorage::SetElementTimes-Methode (objidl.h)

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 Uhrzeit geändert werden soll. Wenn NULL festgelegt ist, wird die Zeit für den Stammspeicher anstelle 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: 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, da zu viele geöffnete Dateien vorhanden sind.
STG_E_REVERTED Das Speicherobjekt wurde durch einen Revertvorgang oberhalb des Objekts in der Transaktionsstruktur ungültig.

Bemerkungen

SetElementTimes legt Zeitstatistiken für das angegebene Speicherelement innerhalb dieses Speicherobjekts fest.

Nicht alle Dateisysteme unterstützen alle Zeitwerte. Diese Methode legt diese Zeiten fest, die unterstützt werden, 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

   
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 – Zusammengesetzte Dateiimplementierung

IStorage::Stat