Método IFunctionDiscovery::CreateInstanceCollectionQuery (functiondiscoveryapi.h)

[A Descoberta de Funções está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Cria uma consulta para uma coleção de instâncias de função específicas.

Sintaxe

HRESULT CreateInstanceCollectionQuery(
  [in]      const WCHAR                      *pszCategory,
  [in]      const WCHAR                      *pszSubCategory,
  [in]      BOOL                             fIncludeAllSubCategories,
  [in]      IFunctionDiscoveryNotification   *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                   *pfdqcQueryContext,
  [out]     IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);

Parâmetros

[in] pszCategory

A categoria da consulta. Consulte Definições de categoria.

[in] pszSubCategory

A subcategoria da consulta. Consulte Definições de subcategoria. Este parâmetro pode ser NULL.

As consultas de subcategoria só têm suporte para categorias em camadas e algumas categorias de provedor. O Provedor de Registro, o provedor de associação PnP-X e o provedor de publicação dão suporte a consultas de subcategoria. Provedores personalizados podem ser projetados explicitamente para dar suporte a consultas de subcategoria. Isso significa que o parâmetro pszSubCategory deve ser definido como um valor não NULL somente quando o parâmetro pszCategory é definido como FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION ou um valor de categoria personalizado definido para uma categoria em camadas ou um provedor personalizado que dá suporte a consultas de subcategoria.

[in] fIncludeAllSubCategories

Se TRUE, esse método criará recursivamente uma consulta para todas as subcategorias da categoria especificada em pszCategory, retornando uma coleção que contém instâncias de função de todas as subcategorias de pszCategory.

Se FALSE, esse método restringirá a consulta criada para retornar instâncias de função na categoria especificada por pszCategory e a subcategoria especificada por pszSubCategory.

[in] pIFunctionDiscoveryNotification

Um ponteiro para a interface IFunctionDiscoveryNotification implementada pelo aplicativo de chamada. Este parâmetro pode ser NULL. Esse ponteiro é válido até que o objeto de consulta retornado seja liberado.

[in, out] pfdqcQueryContext

Um ponteiro para o contexto no qual a consulta foi criada. O tipo FDQUERYCONTEXT é definido como um DWORDLONG.

[out] ppIFunctionInstanceCollectionQuery

Um ponteiro para o ponteiro da interface IFunctionInstanceCollectionQuery .

Valor retornado

Os possíveis valores retornados incluem, mas não se limitam a, o seguinte.

Valor/código retornado	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	O valor de pszCategory ou pIID é inválido. O valor retornado no parâmetro ppIFunctionInstanceCollectionQuery é NULL.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	O valor de pszCategory ou pszSubCategory é desconhecido.

Comentários

Se pIFunctionDiscoveryNotification for especificado, ele habilitará o processo de notificação de alteração da Descoberta de Funções. Este parâmetro pode ser NULL. No entanto, ele é necessário para provedores de rede, pois eles não retornam resultados síncronos. Os provedores de rede do Function Discovery retornam apenas instâncias por meio da interface IFunctionDiscoveryNotification .

Esse método inicializa apenas a chamada de consulta. O método Execute da interface IFunctionInstanceCollectionQuery retornado em ppIFunctionInstanceCollectionQuery deve ser chamado para executar a consulta e retornar todos os dados.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	functiondiscoveryapi.h
DLL	FunDisc.dll

Confira também

Consultas de descoberta de funções

IFunctionDiscovery