Метод 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, optional]
-
Указывает, интерпретируется ли возвращаемое значение как местное время. Затем свойство UTC содержит местное время, преобразованное в правильное смещение в формате UTC. Если значение равно FALSE, значение интерпретируется как UTC со смещением нуля (0).
Возвращаемое значение
Дата и время в формате FILETIME .
Коды ошибок
После завершения метода GetFileTime объект Err может содержать код ошибки в следующем списке.
-
wbemErrFailed — 2147749889 (0x80041001)
-
Вызов не выполнен.
Remarks
VT_DATE и значения FILETIME не могут содержать поля с подстановочными знаками.
Метод GetFileTime завершается сбоем (wbemErrFailed), если любое из следующих свойств равно FALSE:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
При успешном возвращении из SetFileTime все эти свойства имеют значение TRUE.
Примеры
Примеры использования объекта SWbemDateTime для преобразования значений CIM DATETIME в формат FILETIME или формат VT_DATE см. в разделе "Задачи WMI: Даты и время". Описание формата CIM DATETIME см. в разделе "Формат даты и времени".
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Header |
|
| Библиотека типов |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |