metode SWbemObject.InstancesAsync_

Artikel
06/13/2023

Metode InstancesAsync_SWbemObject secara asinkron memasok 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

SWbemObject.InstancesAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

objWbemSink [in]: Sink objek yang mengembalikan instans.
iFlags [in, opsional]: Bilangan bulat yang menentukan perilaku panggilan. Parameter ini dapat menerima nilai berikut.
wbemFlagSendStatus (128 (0x80)): Menyebabkan panggilan asinkron mengirim pembaruan status ke penanganan aktivitas SWbemSink.OnProgress untuk sink objek.
wbemFlagDontSendStatus (0 (0x0)): Mencegah panggilan asinkron mengirim pembaruan status ke penanganan aktivitas OnProgress untuk sink objek.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Menyebabkan WMI mengembalikan deskripsi kelas dan properti yang dilokalkan. Untuk informasi selengkapnya, lihat Melokalisasi Informasi Kelas WMI.

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.

objWbemAsyncContext [in, opsional]

Ini adalah objek SWbemNamedValueSet yang kembali ke sink objek untuk mengidentifikasi sumber panggilan asinkron asli. Gunakan parameter ini jika Anda melakukan beberapa panggilan asinkron menggunakan sink objek yang sama. Untuk menggunakan parameter ini, buat objek SWbemNamedValueSet dan gunakan metode SWbemNamedValueSet.Add untuk menambahkan nilai yang mengidentifikasi panggilan asinkron yang Anda buat. Objek SWbemNamedValueSet ini dikembalikan ke sink objek dan sumber panggilan dapat diekstrak menggunakan metode SWbemNamedValueSet.Item . Untuk informasi selengkapnya, lihat Memanggil Metode.

Menampilkan nilai

Metode ini tidak mengembalikan nilai. Jika berhasil, sink menerima peristiwa OnObjectReady per instans. Setelah instans terakhir, sink objek akan menerima peristiwa OnCompleted .

Kode kesalahan

Setelah menyelesaikan metode InstancesAsync_ , 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

Panggilan ini segera kembali. Objek dan status yang diminta dikembalikan ke pemanggil melalui panggilan balik yang dikirimkan ke sink yang ditentukan dalam objWbemSink. Untuk memproses setiap objek saat tiba, buat objWbemSink. Subroutine peristiwa OnObjectReady. Setelah semua objek dikembalikan, Anda dapat melakukan pemrosesan akhir dalam implementasi objWbemSink Anda. Peristiwa OnCompleted .

Panggilan balik asinkron memungkinkan pengguna yang tidak diautentikasi untuk menyediakan data ke sink. Ini menimbulkan risiko keamanan pada skrip dan aplikasi Anda. Untuk menghilangkan risiko, gunakan komunikasi semisinkron atau komunikasi sinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Metode InstancesAsync_ hanya berfungsi untuk objek kelas. Ini bukan kesalahan untuk koleksi yang dikembalikan memiliki elemen nol (0).

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