Metode SWbemServices.SubclassesOfAsync

Metode SubclassesOfAsync dari objek SWbemServices mengembalikan kumpulan subkelas untuk kelas tertentu. Hanya gunakan metode ini untuk objek kelas.

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

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

Sintaks

SWbemServices.SubclassesOfAsync( _
  ByVal ObjWbemSink, _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

ObjWbemSink

Wajib diisi. Sink objek yang menerima subkelas secara asinkron. Buat objek SWbemSink untuk menerima objek.

strSuperclass [opsional]

Menentukan nama kelas induk. Hanya kelas yang merupakan subkelas dari kelas ini yang dikembalikan dalam enumerator. Jika parameter ini kosong, dan jika iFlags adalah wbemQueryFlagShallow, hanya kelas tingkat atas yang dikembalikan (yaitu, kelas yang tidak memiliki kelas induk). Jika parameter ini kosong, dan jika iFlags adalah wbemQueryFlagDeep, semua kelas dalam namespace dikembalikan.

iFlags [opsional]

Menentukan kedalaman enumerasi panggilan. Nilai default untuk parameter ini adalah wbemQueryFlagDeep. Parameter ini dapat menerima nilai berikut.

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 rekursif ke dalam semua subkelas yang berasal dari kelas induk yang ditentukan. Kelas induk tidak dikembalikan dalam enumerasi.

wbemFlagSendStatus (128 (0x80))

Menyebabkan panggilan asinkron mengirim pembaruan status ke penanganan aktivitas 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 data amandemen kelas dengan definisi kelas dasar. Untuk informasi selengkapnya, lihat Melokalisasi Informasi Kelas WMI.

objwbemNamedValueSet [opsional]

Biasanya, parameter 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 mendokumentasikan nama nilai yang dikenali, jenis data nilai, nilai yang diizinkan, dan semantik.

objWbemAsyncContext [opsional]

Objek SWbemNamedValueSet yang kembali ke sink objek untuk mengidentifikasi sumber panggilan asinkron asli. Gunakan parameter ini untuk 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 lakukan. Objek SWbemNamedValueSet ini dikembalikan ke sink objek dan sumber panggilan dapat diekstraksi menggunakan metode SWbemNamedValueSet.Item . Untuk informasi selengkapnya, lihat Memanggil Metode.

Nilai kembali

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

Kode kesalahan

Setelah penyelesaian metode SubclassesOfAsync , objek Err mungkin berisi salah satu kode kesalahan dalam daftar berikut.

Catatan

Koleksi yang dikembalikan dengan elemen nol bukanlah kesalahan.

wbemErrAccessDenied - 2147749891 (0x80041003)

Pengguna saat ini tidak memiliki izin untuk melihat satu atau beberapa kelas yang dikembalikan oleh panggilan.

wbemErrFailed - 2147749889 (0x80041001)

Kesalahan yang tidak ditentukan.

wbemErrInvalidClass - 2147749904 (0x80041010)

Kelas yang ditentukan tidak ada.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Parameter tidak valid ditentukan.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Tidak cukup memori 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 terhadap skrip dan aplikasi Anda. Untuk menghilangkan risiko, lihat Mengatur Keamanan pada Panggilan Asinkron.

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

SWbemObjectSet