Metode SWbemDateTime.GetFileTime
Metode GetFileTime objek SWbemDateTime mengonversi nilai tanggal dan waktu dalam format DATETIME CIM ke format FILETIME.
Jika parameter diatur ke TRUE, maka nilai yang dikembalikan mewakili waktu lokal untuk klien. Jika tidak, nilai yang dikembalikan adalah waktu Waktu Universal Terkoordinasi (UTC). Struktur DATETIME FILETIME adalah nilai 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 tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.
Sintaks
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Parameter
-
bIsLocaL [in, opsional]
-
Menunjukkan apakah nilai yang dikembalikan ditafsirkan sebagai waktu lokal. Properti UTC kemudian berisi waktu lokal yang dikonversi ke offset Coordinated Universal Times (UTC) yang benar. Jika nilainya FALSE, maka nilai ditafsirkan sebagai UTC dengan offset nol (0).
Nilai kembali
Tanggal dan waktu dalam format FILETIME .
Kode kesalahan
Setelah menyelesaikan metode GetFileTime , objek Err mungkin berisi kode kesalahan dalam daftar berikut.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Panggilan gagal.
Keterangan
VT_DATE dan nilai FILETIME tidak boleh berisi bidang kartubebas.
Metode GetFileTime gagal (wbemErrFailed) jika salah satu properti berikut adalah FALSE:
- TahunDispesifikasikan
- MonthSpecified
- DaySpecified
- Jam Ditentukan
- MenitDispesifikasikan
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Pada pengembalian yang berhasil dari SetFileTime, semua properti ini diatur ke TRUE.
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 |
|
| Pustaka jenis |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |