勇芳软件工作室.汉化:  Windows Management Instrumentation > Scripting API for WMI > Scripting API Objects > SWbemDateTime >

GetVarDate Method

Previous pageReturn to chapter overviewNext page

描述

 

SWbemDateTime对象的GetVarDate方法将CIM DATETIME格式的日期和时间值转换为VT_DATE格式。

 

VT_DATE格式是Visual Basic和ActiveX使用的自动化变体DATETIME值。

 

PowerBASIC 语法

 

METHOD GetVarDate ( _

OPTIONAL BYVAL bIsLocal AS INTEGER _

) AS DOUBLE

 

参数

 

bIsLocal

 

VARIANT_BOOL.指示返回值是否被解释为本地时间。UTC属性然后包含转换为正确的协调世界时(UTC)偏移量的本地时间。如果值为FALSE,则该值将被解释为具有零(0)偏移量的UTC。

 

返回值

 

VT_DATE格式的日期和时间值。

 

OBJRESULT

 

错误(名称/十进制/十六进制)

含义

wbemErrFailed

-2147217407

&H80041001

通话失败。

 

备注

 

VT_DATEFILETIME值不能包含通配符字段。

 

GetVarDate方法失败(wbemErrFailed)如果以下任何属性为FALSE

 

·YearSpecified
·MonthSpecified
·DaySpecified
·HoursSpecified
·MinutesSpecified
·SecondsSpecified
·MicrosecondsSpecified
·UTCSpecified

 

SetVarDate成功返回后,所有这些属性都设置为TRUE.

 

成功拨打SetVarDate后,DATETIME值始终被解释为绝对值DATETIME,而不是间隔,IsInterval设置为FALSE.

 

如果IsInterval设置为TRUE,则调用GetVarDate将导致wbemErrFailed错误。

 

当您调用GetVarDate时,会导致精度损失,因为datetime值的分辨率为1微秒({989796007)),而VT_DATE的值分辨率为500毫秒。

 

要求

 

客户

需要Windows Vista或Windows XP。

服务器

需要Windows Server 2008或Windows Server 2003。

类型库

使用Wbemdisp.tlb。

Wbemdisp.inc,

DLL

需要Wbemdisp.dll。