metode SWbemObject.Instances_
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 |
|
Pustaka jenis |
|
DLL |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |