Metodo ICOMAdminCatalog::GetCollectionByQuery (comadmin.h)

Recupera una raccolta nel catalogo COM+ in base ai valori delle proprietà chiave per tutti gli elementi padre.

Sintassi

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

Parametri

[in] bstrCollName

Nome della raccolta da recuperare.

[in] ppsaVarQuery

Riferimento a una matrice costituita da valori di proprietà chiave per tutti gli elementi padre della raccolta da recuperare.

[out, retval] ppCatalogCollection

Interfaccia ICatalogCollection per la raccolta.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Commenti

Il valore della proprietà ICatalogObject::Key per un elemento è un GUID che serve per identificarlo in modo univoco nel catalogo COM+.

Il metodo GetCollectionByQuery recupera qualsiasi raccolta nel catalogo, in base ai valori chiave per tutti gli elementi padre. Tuttavia, con le raccolte ErrorInfo, PropertyInfo e RelatedCollectionInfo , questo metodo si comporta in modo diverso. Se si specifica una di queste raccolte, GetCollectionByQuery restituisce sempre la raccolta denominata immediatamente relativa all'insieme Root .

Per ottenere l'insieme ErrorInfo, PropertyInfo o RelatedCollectionInfo relativo a una raccolta arbitraria nel catalogo e non relativa all'insieme Root , utilizzare il metodo GetCollection dalla raccolta padre.

Per un elenco completo delle raccolte disponibili, vedere Raccolte di amministrazione COM+.

Requisiti

Vedi anche

ICOMAdminCatalog