Метод SWbemDateTime.GetVarDate

  • Статья

Метод GetVarDate объекта SWbemDateTime преобразует значение даты и времени в формате CIM DATETIME в формат VT_DATE .

Формат VT_DATE — это значение DATETIME варианта автоматизации, используемое Visual Basic и ActiveX.

Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.

Синтаксис

vdate = .GetVarDate( _
  [ ByVal bIsLocal ] _
)

Параметры

bIsLocal [in, optional]

Указывает, интерпретируется ли возвращаемое значение как местное время. Свойство UTC содержит местное время, преобразованное в правильное смещение в формате UTC. Если значение равно FALSE, значение интерпретируется как UTC со смещением нуля (0).

Возвращаемое значение

Значение даты и времени в формате VT_DATE .

Комментарии

значения VT_DATE и FILETIME не могут содержать поля с подстановочными знаками.

Метод GetVarDate завершается ошибкой (wbemErrFailed), если одно из следующих свойств имеет значение FALSE:

При успешном возвращении из SetVarDate всем этим свойствам присваивается значение TRUE.

После успешного вызова SetVarDate значение DATETIME всегда интерпретируется как абсолютное значение DATETIME , а не интервал, а isInterval имеет значение FALSE.

Если параметр IsInterval имеет значение TRUE, вызов GetVarDate приводит к ошибке wbemErrFailed .

Некоторая потеря точности происходит при вызове GetVarDate, так как значения datetime имеют разрешение в один микросекунд (s), а VT_DATE значения — разрешение 500 миллисекунд.

Примеры

Примеры использования объекта SWbemDateTime для преобразования значений CIM DATETIME в формат FILETIME или VT_DATE и из нее см. в разделе Задачи WMI: даты и время. Описание формата CIM DATETIME см. в разделе Формат даты и времени.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Заголовок
Wbemdisp.h
Библиотека типов
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
 CLSID_SWbemDateTime
IID
 IID_ISWbemDateTime

См. также раздел

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME