Metode IWbemHiPerfProvider::GetObjects (wbemprov.h)

Artikel
08/27/2023

Metode IWbemHiPerfProvider::GetObjects menyisipkan properti non-kunci objek dalam array yang disediakan. WMI memanggil GetObjects sebagai respons terhadap panggilan IWbemServices::GetObject . Jika penyedia tidak menerapkan GetObjects, WMI mencoba melayani permintaan GetObject dengan panggilan ke metode IWbemHiPerfProvider::CreateRefreshableObject .

Catatan Jika penyedia tidak menerapkan metode ini, penyedia harus mengembalikan WBEM_E_PROVIDER_NOT_CAPABLE.

Sintaks

HRESULT GetObjects(
  [in]      IWbemServices     *pNamespace,
  [in]      long              lNumObjects,
  [in, out] IWbemObjectAccess **apObj,
            long              lFlags,
            IWbemContext      *pContext
);

Parameter

[in] pNamespace

Penunjuk IWbemServices kembali ke Manajemen Windows, yang dapat melayani permintaan apa pun yang dibuat oleh penyedia. Penyedia harus memanggil AddRef pada pointer ini jika akan memanggil kembali ke Manajemen Windows selama eksekusinya.

[in] lNumObjects

Bilangan bulat yang berisi jumlah objek yang Anda ambil.

[in, out] apObj

Penunjuk ke array objek IWbemObjectAccess . Metode GetObjects menyisipkan properti kunci dari setiap objek ke dalam array ini.

lFlags

Dicadangkan. Parameter ini harus berupa 0.

pContext

Biasanya NULL; jika tidak, pointer ke objek IWbemContext yang diperlukan oleh satu atau beberapa penyedia kelas dinamis. Nilai dalam objek konteks harus ditentukan dalam dokumentasi penyedia tertentu. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI..

Mengembalikan nilai

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

Keterangan

Objek yang diminta akan mengisi properti kuncinya.

Contoh

Contoh kode berikut menjelaskan cara mengimplementasikan GetObjects.

HRESULT CMyHiPerfProvider::GetObjects(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */  long lNumObjects,
  /* [in,out] */IWbemObjectAccess **apObj,
  /* [in] */long lFlags,
  /* [in] */IWbemContext *pCtx
)
{

  for ( long i = 0; i < lNumObjects; i++ )
  {
      // Validate the instance (that is, ensure
      // the path is good); if it fails, return
      // the error.

      // For example, create a method that validates
      // the IWbemObjectAccess instance and returns
      // false if validation failed.
      /*if ( !ValidateInstance( apObj[i] ) )
          return WBEM_E_NOT_FOUND;*/

      // Fill out the instance.
      // For example, create a method that assigns
      // a value to the IWbemObjectAccess instance.
      /*FillInstance( apObj[i] );*/
  }

  return WBEM_S_NO_ERROR;
}

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemprov.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Wmiprvsd.dll