Metode SWbemServices.Get

Artikel
06/13/2023

Metode Get objek SWbemServices mengambil objek, yaitu definisi kelas atau instans, berdasarkan jalur objek. Metode ini hanya mengambil objek dari namespace layanan yang terkait dengan objek SWbemServices saat ini.

Metode ini dipanggil dalam mode sinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.

Sintaks

objWbemObject = .Get( _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parameter

strObjectPath [opsional]: String yang berisi jalur objek objek yang akan diambil. Jika nilai ini kosong, objek kosong yang dikembalikan dapat menjadi kelas baru. Untuk informasi selengkapnya, lihat Menjelaskan Lokasi Objek WMI.
iFlags [opsional]: Bilangan bulat yang menentukan perilaku kueri. Parameter ini dapat menerima nilai berikut.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Menyebabkan WMI mengembalikan data amandemen kelas dengan definisi kelas dasar. Untuk informasi selengkapnya tentang kualifikasi yang diubah, lihat Melokalisasi Informasi Kelas WMI.

objWbemNamedValueSet [opsional]

Biasanya, ini tidak ditentukan. Jika tidak, ini adalah objek SWbemNamedValueSet yang elemennya mewakili informasi konteks yang dapat digunakan oleh penyedia yang melayani permintaan. Penyedia yang mendukung atau memerlukan informasi tersebut harus men dokumentasikan nama nilai yang dikenali, jenis data nilai, nilai yang diizinkan, dan semantik.

Menampilkan nilai

Jika berhasil, metode ini mengembalikan objek SWbemObject yang mewakili objek yang diminta.

Kode kesalahan

Setelah menyelesaikan metode Get , objek Err mungkin berisi salah satu kode kesalahan dalam daftar berikut.

wbemErrAccessDenied - 2147749891 (0x80041003): Pengguna saat ini tidak memiliki izin untuk mengakses objek.
wbemErrFailed - 2147749889 (0x80041001): Kesalahan yang tidak ditentukan.
wbemErrInvalidParameter - 2147749896 (0x80041008): Parameter yang ditentukan tidak valid.
wbemErrInvalidObjectPath - 2147749946 (0x8004103A): Jalur yang ditentukan tidak valid.
wbemErrNotFound - 2147749890 (0x80041002): Objek yang diminta tidak dapat ditemukan.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memori tidak cukup untuk menyelesaikan operasi.

Keterangan

Tidak seperti metode ExecQuery dan InstancesOf , metode Get selalu mengembalikan SWbemObject yang mewakili instans tertentu dari sumber daya yang dikelola WMI. Untuk mendapatkan instans tertentu dari sumber daya yang dikelola WMI menggunakan metode Get, Anda harus memberi tahu Dapatkan instans untuk mengambil dengan melewati metode jalur objek, seperti yang ditunjukkan dalam skrip berikut.

strComputer = "."
Set objSWbemServices = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set objSWbemObject = objSWbemServices.Get("Win32_Service.Name='Messenger'")
Wscript.Echo "Name:         " & objSWbemObject.Name        & vbCrLf & _
             "Display Name: " & objSWbemObject.DisplayName & vbCrLf & _
             "Start Mode:   " & objSWbemObject.StartMode   & vbCrLf & _
             "State:        " & objSWbemObject.State

Anda dapat menggunakan metode ini untuk mendapatkan objek singleton , seperti __CIMOMIdentification, yang berisi informasi versi tentang penginstalan WMI yang sedang berjalan.

Anda dapat memeriksa repositori dengan alat tampilan seperti CIM Studio untuk memverifikasi bahwa kelas dan instans baru muncul. Untuk contoh menghapus kelas dan instans dari repositori, lihat SWbemServices.Delete atau SWbemObject.Delete_.

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_SWbemServices
IID	IID_ISWbemServices

Lihat juga

SWbemServices
SWbemObject