Método SWbemDateTime.GetFileTime

  • Artículo

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:

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
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
Archivo DLL
Wbemdisp.dll
CLSID
 CLSID_SWbemDateTime
IID
 IID_ISWbemDateTime

Consulte también

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME