Bagikan melalui


Metode SWbemServices.AssociatorsOfAsync

Metode AssociatorsOfAsync dari objek SWbemServices mengembalikan kumpulan objek (kelas atau instans) yang disebut titik akhir yang terkait dengan objek tertentu. Panggilan ke AssociatorsOfAsync segera kembali, dan hasil dan status dikembalikan ke pemanggil melalui peristiwa yang dikirimkan ke sink yang ditentukan dalam objWbemSink. Untuk menangani setiap objek yang dikembalikan, buat objWbemSink. Penanganan aktivitas OnObjectReady .

Setelah semua objek tiba, pemrosesan dilakukan di objWbemSink. Peristiwa OnCompleted . Metode ini melakukan fungsi yang sama dengan yang dilakukan kueri ASSOCIATORS OF WQL. Untuk informasi selengkapnya tentang membuat sink, lihat Menerima Peristiwa WMI.

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.AssociatorsOfAsync( _
  ByVal objWbemSink, _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ 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 dari kelas atau instans sumber. Untuk informasi selengkapnya, lihat Menjelaskan Lokasi Objek WMI.

strAssocClass [opsional]

String yang berisi kelas asosiasi. Ketika 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. Default untuk parameter ini adalah wbemFlagDontSendStatus. 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 WMI mengembalikan data amandemen kelas bersama dengan definisi kelas dasar. Untuk informasi selengkapnya tentang kualifikasi yang diubah, 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.

objWbemAsyncContext [opsional]

Objek SWbemNamedValueSet yang kembali ke sink objek untuk mengidentifikasi sumber panggilan asinkron asli. Gunakan parameter ini jika Anda 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 AssociatorsOfAsync , 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)

Tidak cukup memori untuk menyelesaikan operasi.

wbemErrNotFound - 2147749890 (0x80041002)

Item yang diminta tidak ditemukan.

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

Gunakan parameter objWbemAsyncContext dalam skrip untuk memverifikasi sumber panggilan.

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

SWbemObject.Associators_

SWbemObject.AssociatorsAsync_

SWbemObject.References_

SWbemObject.ReferencesAsync_

SWbemServices.ReferencesTo

SWbemServices.ReferencesToAsync