Metode SWbemServices.AssociatorsOf
Metode AssociatorsOf dari objek SWbemServices mengembalikan kumpulan objek (kelas atau instans) yang disebut titik akhir yang terkait dengan objek tertentu. Metode ini melakukan fungsi yang sama dengan yang dilakukan kueri ASSOCIATORS OF WQL.
Metode ini dipanggil dalam mode semisinkron secara default. Untuk informasi selengkapnya, lihat Memanggil Metode.
Untuk penjelasan tentang sintaks ini, lihat Konvensi Dokumen untuk Scripting API.
Sintaks
objWbemObjectSet = .AssociatorsOf( _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parameter
-
strObjectPath
-
Wajib diisi. String yang berisi jalur objek dari kelas atau instans sumber. Untuk informasi selengkapnya, lihat Menjelaskan Lokasi Objek WMI.
-
strAssocClass [opsional]
-
String yang berisi kelas asosiasi. Jika ditentukan, parameter ini menunjukkan bahwa titik akhir yang dikembalikan harus dikaitkan dengan sumber melalui kelas asosiasi yang ditentukan atau kelas yang berasal dari kelas asosiasi ini.
-
strResultClass [opsional]
-
String yang berisi nama kelas. Jika ditentukan, parameter opsional ini menunjukkan bahwa titik akhir yang dikembalikan harus dimiliki atau berasal dari kelas yang ditentukan dalam parameter ini.
-
strResultRole [opsional]
-
String yang berisi nama properti. Jika ditentukan, parameter ini menunjukkan bahwa titik akhir yang dikembalikan harus memainkan peran tertentu dalam hubungannya dengan objek sumber. Peran didefinisikan dengan nama properti tertentu (yang harus menjadi properti referensi) dari asosiasi.
-
strRole [opsional]
-
String yang berisi nama properti. Jika ditentukan, parameter ini menunjukkan bahwa titik akhir yang dikembalikan harus berpartisipasi dalam asosiasi dengan objek sumber tempat objek sumber memainkan peran tertentu. Peran didefinisikan dengan nama properti tertentu (yang harus menjadi properti referensi) dari asosiasi.
-
bClassesOnly [opsional]
-
Nilai Boolean yang menunjukkan apakah daftar nama kelas harus dikembalikan daripada instans kelas aktual. Ini adalah kelas tempat instans titik akhir berada. Nilai default untuk parameter ini adalah FALSE.
-
bSchemaOnly [opsional]
-
Nilai Boolean yang menunjukkan apakah kueri berlaku untuk skema daripada data. Nilai default untuk parameter ini adalah FALSE. Ini hanya dapat diatur ke TRUE jika parameter strObjectPath menentukan jalur objek kelas. Ketika diatur ke TRUE, kumpulan titik akhir yang dikembalikan mewakili kelas yang cocok yang terkait dengan kelas sumber dalam skema.
-
strRequiredAssocQualifier [opsional]
-
String yang berisi nama kualifikasi. Jika ditentukan, parameter ini menunjukkan bahwa titik akhir yang dikembalikan harus dikaitkan dengan objek sumber melalui kelas asosiasi yang menyertakan kualifikasi yang ditentukan.
-
strRequiredQualifier [opsional]
-
String yang berisi nama kualifikasi. Jika ditentukan, parameter ini menunjukkan bahwa titik akhir yang dikembalikan harus menyertakan kualifikasi yang ditentukan.
-
iFlags [opsional]
-
Bilangan bulat yang menentukan bendera tambahan ke operasi. Nilai default untuk parameter ini adalah wbemFlagReturnImmediately, yang memanggil metode dalam mode semisinkron. Parameter ini dapat menerima nilai berikut.
-
wbemFlagForwardOnly (32 (0x20))
-
Menyebabkan enumerator hanya maju dikembalikan. Enumerator hanya penerusan umumnya jauh lebih cepat dan menggunakan lebih sedikit memori daripada enumerator konvensional, tetapi mereka tidak mengizinkan panggilan untuk SWbemObject.Clone_.
-
wbemFlagBidirectional (0 (0x0))
-
Menyebabkan WMI mempertahankan pointer ke objek enumerasi hingga klien merilis enumerator.
-
wbemFlagReturnImmediately (16 (0x10))
-
Menyebabkan panggilan untuk segera kembali.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Menyebabkan panggilan ini diblokir hingga kueri selesai. Bendera ini memanggil metode dalam mode sinkron.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Menyebabkan 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 tersebut harus mendokumentasikan nama nilai yang dikenali, jenis data nilai, nilai yang diizinkan, dan semantik.
Nilai kembali
Jika panggilan berhasil, objek SWbemObjectSet dikembalikan.
Kode kesalahan
Setelah penyelesaian metode AssociatorsOf , 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)
-
Tidak cukup memori untuk menyelesaikan operasi.
-
wbemErrNotFound - 2147749890 (0x80041002)
-
Item yang diminta tidak ditemukan.
Keterangan
Metode ini mengambil instans sumber daya terkelola yang terkait dengan sumber daya tertentu melalui satu atau beberapa kelas asosiasi. Anda menyediakan jalur objek untuk titik akhir asal, dan AssociatorsOf mengembalikan sumber daya terkelola di titik akhir yang berlawanan. Metode AssociatorsOf melakukan fungsi yang sama dengan yang dilakukan kueri ASSOCIATORS OF WQL.
Untuk informasi selengkapnya tentang kueri ASSOCIATORS OF WQL, instans sumber, dan titik akhir, 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_SWbemServices |
IID |
IID_ISWbemServices |