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

Adiciona uma restrição de propriedade à consulta.

Esse método limita os resultados da consulta a apenas instâncias de função com uma chave de propriedade (PKEY) correspondente à restrição especificada.

Sintaxe

HRESULT AddPropertyConstraint(
  [in] REFPROPERTYKEY     Key,
  [in] const PROPVARIANT  *pv,
  [in] PropertyConstraint enumPropertyConstraint
);

Parâmetros

[in] Key

A chave de propriedade (PKEY) para a restrição. Para obter mais informações sobre PKEYs, consulte Definições de chave.

[in] pv

Um PROPVARIANT usado para a restrição. Esse tipo deve corresponder ao tipo PROPVARIANT associado a Key.

Veja a seguir os valores possíveis. Observe que apenas um subconjunto dos tipos PROPVARIANT compatíveis com os provedores internos pode ser usado como uma restrição de propriedade.

VT_BOOL

VT_I2

VT_I4

VT_I8

VT_INT

VT_LPWSTR

VT_LPWSTR|VT_VECTOR

VT_UI2

VT_UI4

VT_UI8

VT_UINT

[in] enumPropertyConstraint

Um valor PropertyConstraint que especifica o tipo de comparação a ser usado ao comparar a PKEY da restrição com a PKEY da instância de função.

Valor retornado

Os valores retornados possíveis 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.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Não há suporte para a restrição especificada para a consulta. Não há suporte para a restrição para um tipo VARENUM específico ou não há suporte para o tipo VARENUM .

Comentários

Uma instância de função só corresponderá a uma restrição de propriedade quando o tipo PROPVARIANT da PKEY da instância de função corresponder ao tipo PROPVARIANT do PKEY da restrição e o valor PKEY da instância de função corresponder ao valor PKEY da restrição usando o operador de comparação especificado por enumPropertyConstraint.

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

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ção

IFunctionInstanceCollectionQuery