metode SWbemObject.References_
Metode References_ objek SWbemObject mengembalikan koleksi semua kelas asosiasi atau instans yang merujuk ke objek saat ini.
Metode ini melakukan fungsi yang sama dengan referensi kueri WQL.
Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.
Sintaks
objWbemObjectSet = .References_( _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parameter
-
strResultClass [in, opsional]
-
String yang berisi nama kelas. Jika ditentukan, parameter ini menunjukkan bahwa objek asosiasi yang dikembalikan harus dimiliki atau berasal dari kelas yang ditentukan dalam parameter ini.
-
strRole [in, opsional]
-
String yang berisi nama properti. Jika ditentukan, parameter ini menunjukkan bahwa objek asosiasi yang dikembalikan harus terbatas pada objek sumber yang memainkan peran tertentu. Peran didefinisikan dengan nama properti tertentu (yang harus menjadi properti referensi) dari asosiasi.
-
bClassesOnly [in, opsional]
-
Nilai Boolean yang menunjukkan apakah daftar nama kelas harus dikembalikan atau tidak daripada instans kelas aktual. Ini adalah kelas tempat objek asosiasi berada. Nilai default untuk parameter ini adalah FALSE.
-
bSchemaOnly [in, opsional]
-
Nilai Boolean yang menunjukkan apakah kueri berlaku untuk skema atau tidak, bukan data. Nilai default untuk parameter ini adalah FALSE. Ini hanya dapat diatur ke TRUE jika objek tempat metode ini dipanggil adalah kelas . Ketika diatur ke TRUE, kumpulan titik akhir yang dikembalikan mewakili kelas yang cocok terkait dengan kelas sumber dalam skema.
-
strRequiredQualifier [in, opsional]
-
String yang berisi nama kualifikasi. Jika ditentukan, parameter ini menunjukkan bahwa objek asosiasi yang dikembalikan harus menyertakan kualifikasi yang ditentukan.
-
iFlags [in, opsional]
-
Bilangan bulat yang menentukan bendera tambahan ke operasi. Default untuk parameter ini adalah wbemFlagReturnImmediately, yang mengarahkan panggilan untuk segera kembali daripada menunggu sampai kueri selesai. 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 Instrumentasi Manajemen Windows (WMI) mempertahankan pointer ke objek enumerasi hingga klien merilis enumerator.
-
wbemFlagReturnImmediately (16 (0x10))
-
Menyebabkan panggilan segera kembali.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Menyebabkan panggilan ini diblokir hingga kueri selesai.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Menyebabkan WMI mengembalikan data amandemen kelas dengan definisi kelas dasar. Untuk informasi selengkapnya tentang kualifikasi yang diubah, 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.
Menampilkan nilai
Jika panggilan berhasil, objek SWbemObjectSet dikembalikan.
Kode kesalahan
Setelah penyelesaian metode References_ , objek Err mungkin berisi salah satu kode kesalahan dalam daftar berikut.
-
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.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Parameter tidak valid ditentukan.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memori tidak cukup untuk menyelesaikan operasi.
Keterangan
Untuk informasi selengkapnya tentang REFERENSI kueri WQL terkait, instans sumber, dan objek asosiasi, lihat Pernyataan ASSOCIATORS OF.
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 |