Compartilhar via

Método ICOMAdminCatalog::GetCollectionByQuery (comadmin.h)

  • Artigo

Recupera uma coleção no catálogo COM+ considerando os valores de propriedade de chave para todos os seus itens pai.

Sintaxe

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

Parâmetros

[in] bstrCollName

O nome da coleção a ser recuperada.

[in] ppsaVarQuery

Uma referência a uma matriz que consiste em valores de propriedade de chave para todos os itens pai da coleção a serem recuperados.

[out, retval] ppCatalogCollection

A interface ICatalogCollection para a coleção.

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL e S_OK.

Comentários

O valor da propriedade ICatalogObject::Key para um item é um GUID que serve para identificá-lo exclusivamente no catálogo COM+.

O método GetCollectionByQuery recupera qualquer coleção no catálogo, considerando os valores de chave para todos os seus itens pai. No entanto, com as coleções ErrorInfo, PropertyInfo e RelatedCollectionInfo , esse método se comporta de forma diferente. Se você especificar qualquer uma dessas coleções, GetCollectionByQuery sempre retornará essa coleção nomeada imediatamente em relação à coleção Root .

Para obter a coleção ErrorInfo, PropertyInfo ou RelatedCollectionInfo relativa a uma coleção arbitrária no catálogo e não em relação à coleção Root , use o método GetCollection da coleção pai.

Para obter uma lista completa das coleções disponíveis, consulte Coleções de administração COM+.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho comadmin.h

Confira também

ICOMAdminCatalog