Метод 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 см. в разделе Формат даты и времени.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Заголовок |
|
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |