Metode IWbemServices::ExecMethod (wbemcli.h)

Artikel
08/27/2023

Metode IWbemServices::ExecMethod menjalankan metode yang diekspor oleh objek CIM. Panggilan metode diteruskan ke penyedia yang sesuai tempat panggilan dijalankan. Informasi dan status dikembalikan ke penelepon, yang memblokir hingga panggilan selesai.

Metode tidak diimplementasikan secara langsung oleh Manajemen Windows, tetapi diekspor oleh penyedia metode. Untuk kelas CIM tertentu, metode yang tersedia dan parameternya harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan.

Untuk informasi selengkapnya tentang menjalankan metode, lihat Memanggil Metode.

Sintaks

HRESULT ExecMethod(
  [in]  const BSTR       strObjectPath,
  [in]  const BSTR       strMethodName,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [in]  IWbemClassObject *pInParams,
  [out] IWbemClassObject **ppOutParams,
  [out] IWbemCallResult  **ppCallResult
);

Parameter

[in] strObjectPath

BSTR valid yang berisi jalur objek objek tempat metode dijalankan.

[in] strMethodName

Nama metode untuk objek .

[in] lFlags

Parameter ini dapat diatur ke 0 untuk melakukan panggilan sinkron ini. Untuk menjadikan ini panggilan semisinkron, atur lFlags ke WBEM_FLAG_RETURN_IMMEDIATELY, berikan pointer yang valid untuk parameter ppCallResult , dan panggilan ini segera kembali. Untuk informasi selengkapnya, lihat Memanggil Metode.

[in] pCtx

Biasanya NULL; jika tidak, ini adalah penunjuk ke objek IWbemContext yang dapat digunakan oleh penyedia yang menjalankan metode . Nilai dalam objek konteks harus ditentukan dalam dokumentasi untuk penyedia yang bersangkutan. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI.

[in] pInParams

Mungkin NULL jika tidak ada dalam parameter yang diperlukan untuk menjalankan metode . Jika tidak, ini menunjuk ke IWbemClassObject yang berisi properti yang bertindak sebagai parameter masuk untuk eksekusi metode. Konten objek khusus metode, dan merupakan bagian dari spesifikasi untuk penyedia yang dimaksud. Untuk informasi selengkapnya tentang membuat parameter input, lihat Membuat Objek Parameter di C++.

[out] ppOutParams

Jika bukan NULL, menerima penunjuk ke parameter keluar dan mengembalikan nilai untuk eksekusi metode. Isi objek ini khusus untuk metode, dan merupakan bagian dari spesifikasi untuk penyedia yang bersangkutan. Pemanggil harus memanggil Rilis pada objek yang dikembalikan ketika tidak lagi diperlukan.

[out] ppCallResult

Jika NULL, ini tidak digunakan. Jika ppCallResult ditentukan, ppCallResult harus diatur untuk menunjuk ke NULL pada entri. Dalam hal ini, panggilan segera kembali dengan WBEM_S_NO_ERROR. Parameter ppCallResult menerima pointer ke objek IWbemCallResult baru, yang harus dijajaki untuk mendapatkan hasil eksekusi metode menggunakan metode GetCallStatus . Parameter keluar untuk panggilan tersedia dengan memanggil IWbemCallResult::GetResultObject.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Jika gagal, Anda dapat memperoleh informasi apa pun yang tersedia dari fungsi COM GetErrorInfo.

Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

Keterangan

Jika ppOutParams bukan NULL, klien dapat menentukan jenis nilai pengembalian metode dengan memeriksa properti ReturnValue dari objek yang diacu oleh ppOutParams.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Lihat juga

Memanggil Metode

IWbemCallResult::GetResultObject

IWbemServices

IWbemServices::ExecMethodAsync

Bagikan melalui