Metode SWbemServices.ReferencesToAsync
Metode ReferencesToAsync dari objek SWbemServices mengembalikan semua kelas asosiasi atau instans yang merujuk ke kelas atau instans sumber tertentu. Metode ini melakukan fungsi yang sama dengan yang dilakukan kueri REFERENSI WQL.
Untuk informasi selengkapnya tentang mode asinkron, lihat Memanggil Metode.
Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.
Sintaks
SWbemServices.ReferencesToAsync( _
ByVal ObjWbemSink, _
ByVal strObjectPath, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parameter
-
ObjWbemSink
-
Wajib diisi. Sink objek yang menerima objek secara asinkron. Buat objek SWbemSink untuk menerima objek.
-
strObjectPath
-
Wajib diisi. String yang berisi jalur objek sumber untuk metode ini. Untuk informasi selengkapnya, lihat Melokalisasi Informasi Kelas WMI.
-
strResultClass [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 [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 referensi tertentu dari asosiasi.
-
bClassesOnly [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 [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 parameter strObjectPath menentukan jalur objek kelas. Saat diatur ke TRUE, kumpulan titik akhir yang dikembalikan mewakili kelas yang terkait dengan kelas sumber dalam skema.
-
strRequiredQualifier [opsional]
-
String yang berisi nama kualifikasi. Jika ditentukan, parameter ini menunjukkan bahwa objek asosiasi yang dikembalikan harus menyertakan kualifikasi yang ditentukan.
-
iFlags [opsional]
-
Bilangan bulat yang menentukan bendera tambahan ke operasi. Default untuk parameter ini adalah wbemFlagBidirectional. Parameter ini dapat menerima nilai berikut.
-
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 Instrumentasi Manajemen Windows (WMI) mengembalikan data amandemen kelas bersama 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 konteks harus men dokumentasikan nama nilai yang dikenali, jenis data nilai, nilai yang diizinkan, dan semantik.
objWbemAsyncContext [opsional]
Ini adalah 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 diekstrak 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 menyelesaikan metode ReferencesToAsync , 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.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Parameter tidak valid ditentukan.
-
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 kembali, 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, lihat Mengatur Keamanan pada Panggilan Asinkron.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Header |
|
Pustaka jenis |
|
DLL |
|
CLSID |
CLSID_SWbemServices |
IID |
IID_ISWbemServices |