Метод SWbemDateTime.SetFileTime

Статья
06/13/2023

Метод SetFileTime объекта SWbemDateTime преобразует дату в строковом формате FILETIME в формат CIM datetime .

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

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

Синтаксис

SWbemDateTime.SetFileTime( _
  ByVal strFileTime, _
  [ ByVal bIsLocal ] _
)

Параметры

strFileTime [in]: Значение FILETIME, используемое для задания объекта .
bIsLocal [in, optional]: Если задано значение TRUE, strFileTime интерпретируется как местное время. Свойство UTC содержит местное время, преобразованное в правильное смещение в формате UTC. Если значение bIsLocal равно FALSE, strFileTime преобразуется непосредственно в значение UTC со смещением 0 (ноль).

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

Этот метод не возвращает значение.

Коды ошибок

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

wbemErrInvalidSyntax — 2147749921 (0x80041021): Недопустимый формат strFileTime .

Примеры

Примеры использования объекта 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.SetVarDate
SWbemDateTime
DATETIME

Поделиться через