Metode ICOMAdminCatalog::GetCollectionByQuery (comadmin.h)

Artikel
02/26/2024

Mengambil koleksi pada katalog COM+ mengingat nilai properti kunci untuk semua item induknya.

Sintaks

HRESULT GetCollectionByQuery(
  [in]          BSTR      bstrCollName,
  [in]          SAFEARRAY **ppsaVarQuery,
  [out, retval] IDispatch **ppCatalogCollection
);

Parameter

[in] bstrCollName

Nama koleksi yang akan diambil.

[in] ppsaVarQuery

Referensi ke array yang terdiri dari nilai properti kunci untuk semua item induk koleksi yang akan diambil.

[out, retval] ppCatalogCollection

Antarmuka ICatalogCollection untuk koleksi.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, dan S_OK.

Keterangan

Nilai properti ICatalogObject::Key untuk item adalah GUID yang berfungsi untuk mengidentifikasinya secara unik di katalog COM+.

Metode GetCollectionByQuery mengambil koleksi apa pun pada katalog, mengingat nilai kunci untuk semua item induknya. Namun, dengan koleksi ErrorInfo, PropertyInfo, dan RelatedCollectionInfo , metode ini berkinerja berbeda. Jika Anda menentukan salah satu koleksi ini, GetCollectionByQuery selalu mengembalikan koleksi bernama yang segera relatif terhadap koleksi Root .

Untuk mendapatkan koleksi ErrorInfo, PropertyInfo, atau RelatedCollectionInfo yang relatif terhadap koleksi arbitrer dalam katalog dan tidak relatif terhadap koleksi Root , gunakan metode GetCollection dari koleksi induk.

Untuk daftar lengkap koleksi yang tersedia, lihat Koleksi Administrasi COM+.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	comadmin.h

Lihat juga

ICOMAdminCatalog

Bagikan melalui