Objek SWbemRefresher

Artikel
06/13/2023

Objek SWbemRefresher adalah objek kontainer yang dapat menyegarkan data untuk semua objek yang ditambahkan ke dalamnya. Instans tunggal dan enumerator instans dapat ditambahkan atau dihapus dari kontainer. Kumpulan objek yang ditambahkan, setiap item yang diwakili oleh instans SWbemRefreshableItem , dapat diperlakukan sebagai koleksi dan dijumlahkan. Instans WMI dari kelas apa pun dapat ditambahkan ke objek SWbemRefresher . Bahkan jika penyedia untuk data instans bukan penyedia berkinerja tinggi, objek penyegaran masih dapat memperbarui data pada panggilan Refresh . Jika data disediakan melalui penyedia berkinerja tinggi dan properti AutoReconnectADALAH TRUE, maka objek SWbemRefresher mencoba membangun kembali koneksi yang rusak ke penyedia data. Objek ini dapat dibuat oleh panggilan VBScript CreateObject .

Operasi refresh dapat dilakukan dengan memanggil metode SWbemRefresher.Refresh atau metode SWbemObjectEx.Refresh_ .

Anggota

Objek SWbemRefresher memiliki jenis anggota ini:

Metode
Properti

Metode

Objek SWbemRefresher memiliki metode ini.

Metode	Deskripsi
Menambahkan	Menambahkan objek baru yang dapat di-refresh ke koleksi di objek penyegaran.
AddEnum	Menambahkan enumerator baru ke objek penyegaran.
DeleteAll	Menghapus semua item dari koleksi dalam objek penyegaran.
Item	Mengembalikan item penyegaran tertentu dari koleksi.
Refresh	Updates semua item yang terkandung dalam objek penyegaran.
Hapus	Menghapus objek item penyegar atau objek yang diatur dengan indeks tertentu dari penyegaran.

Properti

Objek SWbemRefresher memiliki properti ini.

Properti	Jenis akses	Deskripsi
Sambungkan Otomatis	Baca-saja	Menunjukkan apakah penyegar secara otomatis tersambung kembali ke penyedia jarak jauh jika koneksi rusak.
Jumlah	Baca-saja	Berisi jumlah item dalam objek penyegaran.

Contoh

Contoh berikut mengilustrasikan pembuatan objek SWbemRefresher , menggunakan metode Tambahkan dan AddEnum untuk menyimpan satu instans dan instans enumerasi, penyegaran data, dan menggunakan properti Item untuk mendapatkan objek SWbemRefreshableItem .

' Get namespace connections
set objServicesCimv2 = GetObject("winmgmts:root\cimv2")
set objServicesDefault = GetObject("winmgmts:root\default")

' Create a refresher object
set objRefresher = CreateObject("WbemScripting.SWbemRefresher")

' Add a single object (SWbemObjectEx) to the refresher. The "@"
' is used because _CIMOMIdentification is a singleton class- only 
' one instance exists. Note that the
' SWbemRefreshableItem.Object property must 
' be specified or the SWbemRefresher.Refresh call will fail.

set objRefreshableItem1 = objRefresher. _
    Add (objServicesDefault, "__CIMOMIdentification=@").Object

' Add an enumerator (SWbemObjectSet object)
' to the refresher. Note that the
' SWbemRefreshableItem.ObjectSet property
' must be specified or the SWbemRefresher.Refresh call will fail. 
set objRefreshableItem2 = objRefresher. _
    AddEnum (objServicesCimv2, "Win32_Process").ObjectSet

' Display number of items in refresher and update the data.
MsgBox "Number of items in refresher = " & objRefresher.Count
objRefresher.Refresh

' Iterate through the refresher. SWbemRefreshable
' Item.IsSet checks for whether the item is an enumerator.
for each RefreshableItem in objRefresher
 if RefreshableItem.IsSet then  
    MsgBox "Item with index " & RefreshableItem.Index &_
    " is an enumerator containing "_
    & RefreshableItem.ObjectSet.Count & " processes"
 else  
      MsgBox "Item with index " & RefreshableItem.Index _
          & " is a single object containing WMI version "_
          &  objRefreshableItem1.VersionCurrentlyRunning
 end if
next

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_SWbemRefresher
IID	IID_ISWbemRefresher

Lihat juga

SWbemRefreshableItem
SWbemObjectEx
Membuat Skrip Objek API

Bagikan melalui