Metodo IStorage::SetElementTimes (objidl.h)

Articolo
02/29/2024

Il metodo SetElementTimes imposta i tempi di modifica, accesso e creazione dell'elemento di archiviazione specificato, se il file system sottostante supporta questo metodo.

Sintassi

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

Parametri

[in] pwcsName

Nome dell'elemento dell'oggetto di archiviazione i cui tempi devono essere modificati. Se NULL, l'ora viene impostata nell'archiviazione radice anziché su uno dei relativi elementi.

[in] pctime

Se l'ora di creazione non deve essere modificata, il nuovo tempo di creazione per l'elemento o NULL .

[in] patime

Ora di accesso nuovo per l'elemento o NULL se l'ora di accesso non deve essere modificata.

[in] pmtime

Il nuovo tempo di modifica per l'elemento o NULL se il tempo di modifica non deve essere modificato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	I valori di ora sono stati impostati correttamente.
E_PENDING	Solo archiviazione asincrona: parte o tutti i dati dell'elemento non sono attualmente disponibili.
STG_E_ACCESSDENIED	Il chiamante non dispone di autorizzazioni sufficienti per modificare l'elemento.
STG_E_FILENOTFOUND	L'elemento con il nome specificato non esiste.
STG_E_INSUFFICIENTMEMORY	L'elemento non è stato modificato a causa di una mancanza di memoria.
STG_E_INVALIDNAME	Non un valore valido per il nome dell'elemento.
STG_E_INVALIDPOINTER	Il puntatore specificato per l'elemento non è valido.
STG_E_INVALIDPARAMETER	Uno dei parametri non è valido.
STG_E_TOOMANYOPENFILES	L'elemento non è stato modificato perché sono presenti troppi file aperti.
STG_E_REVERTED	L'oggetto di archiviazione è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni.

Commenti

SetElementTimes imposta le statistiche temporali per l'elemento di archiviazione specificato all'interno di questo oggetto di archiviazione.

Non tutti i file system supportano tutti i valori temporali. Questo metodo imposta i tempi supportati e ignora il resto. Ogni parametro time-value può essere NULL; che indica che non deve verificarsi alcuna modifica.

Chiamare il metodo IStorage::Stat per recuperare questi valori temporali.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	objidl.h
Libreria	Uuid.lib
DLL	Ole32.dll

Vedi anche

IStorage - Implementazione di file composti

IStorage::Stat

Condividi tramite