Método SWbemDateTime.GetFileTime
El método GetFileTime del objeto SWbemDateTime convierte un valor de fecha y hora en el formato de CIM DATETIME al formato FILETIME.
Si el parámetro se establece en TRUE, el valor devuelto representa una hora local para el cliente. De lo contrario, el valor devuelto es una hora universal coordinada (UTC). Una estructura FILETIMEDATETIME es un valor de 64 bits que representa el número de unidades de 100 nanosegundos que comienza el 1 de enero de 1601. Instrumental de administración de Windows (WMI) trata los valores FILETIME como representaciones de cadena de números de 64 bits sin signo.
Para obtener una explicación de esta sintaxis, consulte Convenciones de documentación para la API de scripting.
Sintaxis
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Parámetros
-
bIsLocaL [entrada, opcional]
-
Indica si el valor devuelto se interpreta como hora local. Posteriormente, la propiedad UTC contiene la hora local convertida con el desplazamiento correcto a la hora universal coordinad (UTC). Si el valor es FALSE, el valor se interpreta como UTC con un desplazamiento cero (0).
Valor devuelto
Fecha y hora en el formato FILETIME.
Códigos de error
Después de completar el método GetFileTime, el objeto Err puede contener el código de error en la lista siguiente.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Se produjo un error en la llamada.
Comentarios
Los valores VT_DATE y FILETIME no pueden contener campos comodín.
Se produce un error en el método GetFileTime (wbemErrFailed) si alguna de las siguientes propiedades es FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Si se devuelve correctamente SetFileTime, todas estas propiedades se establecen en TRUE.
Ejemplos
Para obtener ejemplos de uso del objeto SWbemDateTime para convertir valores DATETIME de CIM al y desde el formato FILETIME o el formato VT_DATE, vea Tareas de WMI: Fechas y horas. Para obtener una descripción del formato DATETIME de CIM, vea Formato de fecha y hora.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |