Метод WBEMTime::SetDMTF (wbemtime.h)

Статья
08/27/2023

[Класс WBEMTime является частью платформы поставщика WMI, которая в настоящее время рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]

Метод SetDMTF задает время в объекте WBEMTime . Время определяется параметром BSTR в формате даты и времени. Аргумент даты и времени ранее полуночи 1 января 1601 г. недопустим.

Синтаксис

BOOL SetDMTF(
  const BSTR wszText
);

Параметры

wszText

BSTR в формате даты и времени.

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

Метод возвращает значение true , если время является допустимым, и false , если время недопустимо.

На внутреннем уровне WBEMTime сохраняет datetime в виде 64-разрядного целого числа. Поэтому при задании даты и времени требуется интерпретация использования звездочки для конкретной реализации.

Если звездочка "*" появляется в любом месте строки datetime входящего трафика, wszText заменяется позиционной строкой datetime по умолчанию "16010101000000.000000+000".

Разделитель микросекунд "." и знак смещения в формате UTC "+/-" должны присутствовать в правильных расположениях. Все остальные позиции заменяются элементом по умолчанию, если в соответствующем расположении обнаружена звездочка.

Например, "1979**********.0000000-0*4" становится "197910101000000.000000-004".

Так как WBEMTime внутренне хранит все значения даты и времени в GMT, результирующее значение UTC -004 приводит к изменению поля минуты таким образом, что внутреннее представление будет "19791010500000.000000+000".

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemtime.h
DLL	FrameDynOS.dll; FrameDyn.dll

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

WBEMTime

WBEMTime::GetBSTR

WBEMTime::GetDMTF