Metode SWbemServices.SubclassesOf

Artikel
06/13/2023

Metode SubclassesOf dari objek SWbemServices mengembalikan objek SWbemObjectSet . Objek ini adalah kumpulan subkelas dari kelas tertentu. Item dalam koleksi yang dikembalikan dapat diperoleh menggunakan metode pengumpulan standar. Untuk informasi selengkapnya, lihat Mengakses Koleksi.

Metode ini hanya berfungsi untuk objek kelas.

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

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

Sintaks

objWbemObjectSet = .SubclassesOf( _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parameter

strSuperclass [opsional]: Menentukan nama kelas induk. Hanya subkelas dari kelas ini yang kembali dalam enumerator. Jika Anda membiarkan 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 iFlags adalah wbemQueryFlagDeep semua kelas dalam namespace dikembalikan.
iFlags [opsional]: Menentukan seberapa rinci panggilan menghitung. Nilai default untuk parameter ini adalah wbemFlagReturnImmediately dan 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 semua subkelas yang berasal dari kelas induk yang ditentukan. Kelas induk tidak dikembalikan dalam enumerasi.
wbemFlagReturnImmediately (16 (0x10)): Menyebabkan panggilan segera kembali.
wbemFlagReturnWhenComplete (0 (0x0)): Menyebabkan panggilan ini diblokir hingga panggilan selesai. Bendera ini memanggil metode dalam mode sinkron.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Menyebabkan WMI mengembalikan data amandemen kelas dengan definisi kelas dasar. Untuk informasi selengkapnya, 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.

Mengembalikan nilai

Jika metode berhasil, objek SWbemObjectSet dikembalikan.

Kode kesalahan

Setelah penyelesaian metode SubclassesOf , 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): Memori tidak cukup untuk menyelesaikan operasi.

Contoh

Sampel PowerShell berikut menunjukkan cara mengambil subkelas kelas pada sistem jarak jauh.

$NameSpace = 'root\ccm'
$ComputerName = 'sccm.company.com'
$WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator"
$WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace)
$WbemClasses = $WbemServices.SubclassesOf()
$WbemClasses

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

Bagikan melalui