Penyedia::GetObject(CInstance*,long,CFrameworkQuery&) metode (provider.h)

[Kelas Penyedia adalah bagian dari Kerangka Kerja Penyedia WMI yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode GetObject dipanggil oleh WMI untuk mengambil instans kelas.

HRESULT GetObject(
        CInstance         *pInstance,
  [ref] long              lFlags,
        CFrameworkQuery & Query
);

pInstance

TBD

[ref] lFlags

Objek kueri yang menunjukkan kumpulan properti yang akan diisi, seperti yang diminta oleh panggilan ke Provider::GetObject.

Penyedia dapat mewujudkan perolehan performa yang signifikan dengan hanya mengisi nilai properti yang diminta ini. Penyedia menentukan properti mana yang diminta dengan menggunakan CFrameworkQuery::IsPropertyRequired. Jika tidak, penyedia harus mengisi semua nilai properti.

Query

TBD

Implementasi penyedia kerangka kerja default dari metode ini mengembalikan WBEM_E_PROVIDER_NOT_CAPABLE ke metode panggilan. Metode IWbemServices::GetObject mencantumkan nilai pengembalian umum, meskipun Anda dapat memilih untuk mengimplementasikan nilai pengembalian COM apa pun.

WMI sering memanggil GetObject sebagai respons terhadap panggilan klien ke IWbemServices::GetObject. Versi WMI penyedia ::GetObject menyediakan instans hanya dengan properti kunci yang diisi. Sebaliknya, penyedia kerangka kerja yang diimplementasikan harus mengisi semua properti lainnya. Berikut ini menjelaskan penimpaan umum GetObject:

1. Tentukan instans mana yang diminta WMI dengan membaca properti kunci dengan metode Get dari CInstance, seperti CInstance::GetCHString.
2. Isi properti instans lainnya menggunakan banyak metode Set dari kelas CInstance , seperti CInstance::SetByte atau CInstance::SetStringArray.