metode SWbemObject.Instances_

Artikel
06/13/2023

Metode Instances_ objek SWbemObject membuat enumerator yang mengembalikan instans objek kelas saat ini. Metode ini mengimplementasikan kueri sederhana. Kueri yang lebih kompleks mungkin memerlukan penggunaan SWbemServices.ExecQuery.

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

Sintaks

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parameter

iFlags [in, opsional]: Bilangan bulat yang menentukan perilaku panggilan. Parameter ini dapat menerima nilai berikut.
wbemFlagForwardOnly (32 (0x20)): Menyebabkan enumerator hanya maju dikembalikan. Enumerator hanya maju umumnya jauh lebih cepat dan menggunakan lebih sedikit memori daripada enumerator konvensional, tetapi mereka tidak mengizinkan panggilan untuk SWbemObject.Clone_.
wbemFlagBidirectional (0 (0x0)): Menyebabkan WMI mempertahankan pointer ke objek enumerasi hingga klien merilis enumerator.
wbemFlagReturnImmediately (16 (0x10)): Nilai default untuk parameter ini. Bendera ini menyebabkan panggilan segera kembali.
wbemFlagReturnWhenComplete ( 0 (0x0)): Menyebabkan panggilan ini diblokir hingga kueri selesai.
wbemQueryFlagShallow (1 (0x1)): Memaksa enumerasi untuk menyertakan hanya subkelas langsung dari kelas induk yang ditentukan.
wbemQueryFlagDeep (0 (0x0)): Default untuk parameter ini. Nilai ini memaksa enumerasi untuk menyertakan semua kelas dalam hierarki.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Menyebabkan WMI mengembalikan data amandemen kelas dengan definisi kelas dasar.

objwbemNamedValueSet [in, 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 metode berhasil, objek SWbemObjectSet akan kembali.

Kode kesalahan

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

wbemErrAccessDenied - 2147749891 (0x80041003): Pengguna saat ini tidak memiliki izin untuk melihat instans kelas yang ditentukan.
wbemErrFailed - 2147749889 (0x80041001): Terjadi kesalahan yang tidak ditentukan.
wbemErrInvalidClass - 2147749904 (0x80041010): Kelas yang ditentukan tidak valid.
wbemErrInvalidParameter - 2147749896 (0x80041008): Parameter yang ditentukan tidak valid.
wbemErrOutOfMemory - 2147749894 (0x80041006): Memori tidak cukup untuk menyelesaikan operasi.

Keterangan

Metode Instances_ hanya berfungsi untuk objek kelas. Ini bukan kesalahan bagi koleksi yang dikembalikan untuk memiliki elemen nol. Perilaku default untuk metode ini semisinkron karena nilai IFlags default wbemFlagReturnImmediately.

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_SWbemObject
IID	IID_ISWbemObject

Lihat juga

SWbemObject
SWbemObjectSet

Bagikan melalui