Метод SWbemDateTime.GetFileTime

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

Если параметр имеет значение TRUE, то возвращаемое значение представляет местное время для клиента. В противном случае возвращаемое значение — время в формате UTC. Структура FILETIMEDATETIME — это 64-разрядное значение, представляющее число единиц 100 наносекунд с начала 1 января 1601 года. Инструментарий управления Windows (WMI) рассматривает значения FILETIME как строковые представления 64-разрядных чисел без знака.

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

Синтаксис

vDate = .GetFileTime( _
  [ ByVal bIsLocaL ] _
)

Параметры

bIsLocaL [in, необязательный]

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

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

Дата и время в формате FILETIME .

Коды ошибок

После завершения метода GetFileTime объект Err может содержать код ошибки из следующего списка.

wbemErrFailed — 2147749889 (0x80041001)

Вызов не выполнен.

Комментарии

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

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

• YearSpecified
• MonthSpecified
• DaySpecified
• Часы, указанные
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

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

Примеры

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

Требования

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

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME