Método IStorage::SetElementTimes (objidl.h)
El método SetElementTimes establece los tiempos de modificación, acceso y creación del elemento de almacenamiento especificado, si el sistema de archivos subyacente admite este método.
Sintaxis
HRESULT SetElementTimes(
[in] const OLECHAR *pwcsName,
[in] const FILETIME *pctime,
[in] const FILETIME *patime,
[in] const FILETIME *pmtime
);
Parámetros
[in] pwcsName
Nombre del elemento de objeto de almacenamiento cuyas horas se van a modificar. Si es NULL, la hora se establece en el almacenamiento raíz en lugar de en uno de sus elementos.
[in] pctime
La nueva hora de creación del elemento o NULL si no se va a modificar la hora de creación.
[in] patime
La nueva hora de acceso para el elemento o NULL si no se va a modificar la hora de acceso.
[in] pmtime
La nueva hora de modificación del elemento o NULL si no se va a modificar la hora de modificación.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
| S_OK | Los valores de hora se establecieron correctamente. |
| E_PENDING | Solo almacenamiento asincrónico: la parte o todos los datos del elemento no están disponibles actualmente. |
| STG_E_ACCESSDENIED | El autor de la llamada no tiene permisos suficientes para cambiar el elemento. |
| STG_E_FILENOTFOUND | El elemento con el nombre especificado no existe. |
| STG_E_INSUFFICIENTMEMORY | El elemento no se cambió debido a una falta de memoria. |
| STG_E_INVALIDNAME | No es un valor válido para el nombre del elemento. |
| STG_E_INVALIDPOINTER | El puntero especificado para el elemento no era válido. |
| STG_E_INVALIDPARAMETER | Uno de los parámetros no era válido. |
| STG_E_TOOMANYOPENFILES | El elemento no se cambió porque hay demasiados archivos abiertos. |
| STG_E_REVERTED | Una operación de reversión por encima de él ha invalidado el objeto de almacenamiento en el árbol de transacciones. |
Comentarios
SetElementTimes establece estadísticas de hora para el elemento de almacenamiento especificado dentro de este objeto de almacenamiento.
No todos los sistemas de archivos admiten todos los valores de tiempo. Este método establece las horas que se admiten y omite el resto. Cada parámetro time-value puede ser NULL; que indica que no debe producirse ninguna modificación.
Llame al método IStorage::Stat para recuperar estos valores de hora.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | objidl.h |
| Library | Uuid.lib |
| Archivo DLL | Ole32.dll |