Método IFunctionInstanceCollectionQuery::AddQueryConstraint (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.]

O método AddQueryConstraint adiciona uma restrição de consulta à consulta.

Esse método permite que o aplicativo filtre o conjunto de resultados apenas para as instâncias que atendem a essa restrição.

Sintaxe

HRESULT AddQueryConstraint(
  [in] const WCHAR *pszConstraintName,
  [in] const WCHAR *pszConstraintValue
);

Parâmetros

[in] pszConstraintName

A restrição de consulta.

[in] pszConstraintValue

O valor da restrição.

Retornar valor

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

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_OUTOFMEMORY	O método não pode alocar a memória necessária para executar essa operação.

Comentários

Se várias restrições forem adicionadas, todas as restrições deverão ter suporte para atender à consulta.

AddQueryConstraint falhará com um erro se o objeto IFunctionInstanceCollectionQuery incluir todas as subcategorias e o método AddQueryConstraint for chamado com o parâmetro pszConstraintName definido como FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Para evitar esse erro, crie um objeto IFunctionInstanceCollectionQuery que não inclua todas as subcategorias. Você pode criar esse objeto chamando CreateInstanceCollectionQuery com o parâmetro fIncludeAllSubCategories definido como false.

Requisitos

Requisito	Valor
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

Definições de restrição

Consultas de descoberta de funções

IFunctionInstanceCollectionQuery