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 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 |