Metode SWbemDateTime.SetFileTime

Artikel
06/13/2023

Metode SetFileTime dari objek SWbemDateTime mengonversi tanggal dalam format FILETIME string ke format tanggalwaktu CIM .

Format FILETIME adalah struktur tanggalwaktu 64-bit yang menunjukkan jumlah unit 100 nanodetik sejak awal 1 Januari 1601. Instrumentasi Manajemen Windows (WMI) memperlakukan nilai FILETIME sebagai representasi string dari angka 64-bit yang tidak ditandatangani.

Untuk penjelasan sintaks, lihat Konvensi Dokumen untuk Scripting API.

Sintaks

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

Parameter

strFileTime [in]: Nilai FILETIME yang digunakan untuk mengatur objek.
bIsLocal [in, opsional]: Jika TRUE, strFileTime ditafsirkan sebagai waktu setempat. Properti Waktu Universal Terkoordinasi (UTC) berisi waktu lokal yang dikonversi ke offset UTC yang benar. Ketika bIsLocalFALSE, maka strFileTime dikonversi langsung menjadi nilai UTC dengan offset 0 (nol).

Nilai kembali

Metode ini tidak mengembalikan nilai.

Kode kesalahan

Setelah menyelesaikan metode SetFileTime , objek Err mungkin berisi kode kesalahan dalam daftar berikut.

wbemErrInvalidSyntax - 2147749921 (0x80041021): Format strFileTime tidak valid.

Keterangan

Setelah panggilan berhasil ke SetFileTime, nilai tanggalwaktu selalu ditafsirkan sebagai nilai absolut (tanggalwaktu), dan IsInterval diatur ke FALSE.

Contoh

Untuk contoh penggunaan objek SWbemDateTime untuk mengonversi nilai CIM DATETIME ke dan dari format FILETIME atau format VT_DATE , lihat Tugas WMI: Tanggal dan Waktu. Untuk deskripsi format DATETIME CIM, lihat Format Tanggal dan Waktu.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	Wbemdisp.h
Pustaka jenis	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

Lihat juga

SWbemDateTime.SetVarDate
SWbemDateTime
DATETIME

Share via