Metodo IStorage::SetElementTimes (objidl.h)
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 |