SWbemDateTime.SetVarDate メソッド

  • [アーティクル]

SWbemDateTime オブジェクトの SetVarDate メソッドは、VT_DATE形式の日付を CIM datetime 形式に変換します。

VT_DATE 値は、Visual Basic と ActiveX で使用されるバリアント datetime 値です。

この構文の説明については、「スクリプト API のドキュメント規則」を参照してください。

構文

SWbemDateTime.SetVarDate( _
  ByVal vdate, _
  [ ByVal bIsLocal ] _
)

パラメーター

vdate [in]

オブジェクトを設定するバリアント型の日付値。 このパラメーターは VT_DATE 形式でなければなりません。

bIsLocaL [in、省略可能]

TRUE の場合、vdate が現地時刻として解釈され、協定世界時 (UTC) プロパティに含まれる現地時刻は、正しい UTC オフセットに変換されます。 bIsLocal が FALSE のとき、vdate はオフセットがゼロ (0) の UTC 値に直接変換されます。

戻り値

このメソッドは値を返しません。

エラー コード

SetVarDate メソッドの完了後、Err オブジェクトに、次のエラー コードが格納される場合があります。

wbemErrInvalidSyntax - 2147749921 (0x80041021)

vdate の形式は無効です。

解説

SetVarDate の呼び出しが成功すると、DATETIME 値は間隔ではなく絶対 datetime 値として解釈され、IsInterval プロパティは FALSE に設定されます。

組み込みの Visual Basic または VBScript 関数 CDate は、SetVarDate への入力として VT_DATE 形式の datetime 値を提供します。

例

SWbemDateTime オブジェクトを使用して CIM DATETIME 値を FILETIME 形式または VT_DATE 形式との間で変換する例については、「WMI タスク: 日付と時刻」を参照してください。 CIM DATETIME 形式の説明については、「日付と時刻の形式」を参照してください。

必要条件

要件 Value
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
ヘッダー
Wbemdisp.h
タイプ ライブラリ
Wbemdisp.tlb
[DLL]
Wbemdisp.dll
CLSID
 CLSID_SWbemDateTime
IID
 IID_ISWbemDateTime

関連項目

SWbemDateTime.SetFileTime

SWbemDateTime

DATETIME