Método IFunctionInstanceCollectionQuery::AddPropertyConstraint (functiondiscoveryapi.h)

[La detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Agrega una restricción de propiedad a la consulta.

Este método limita los resultados de la consulta solo a instancias de función con una clave de propiedad (PKEY) que coincida con la restricción especificada.

Sintaxis

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

Parámetros

[in] Key

Clave de propiedad (PKEY) para la restricción. Para obtener más información sobre PKEYs, vea Definiciones de clave.

[in] pv

PropVARIANT utilizado para la restricción. Este tipo debe coincidir con el tipo PROPVARIANT asociado a Key.

A continuación se muestran los valores posibles. Tenga en cuenta que solo se puede usar un subconjunto de los tipos PROPVARIANT admitidos por los proveedores integrados como restricción de propiedad.

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

Valor PropertyConstraint que especifica el tipo de comparación que se va a usar al comparar el PKEY de la restricción con el PKEY de la instancia de función.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_OUTOFMEMORY
 El método no puede asignar la memoria necesaria para realizar esta operación.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 No se admite la restricción especificada para la consulta. No se admite la restricción para un tipo VARENUM específico o el tipo VARENUM no se admite en absoluto.

Comentarios

Una instancia de función solo coincidirá con una restricción de propiedad cuando el tipo PROPVARIANT de la PKEY de la instancia de función coincide con el tipo PROPVARIANT del PKEY de la restricción y el valor PKEY de la instancia de función coincide con el valor PKEY de la restricción mediante el operador de comparación especificado por enumPropertyConstraint.

Si se agregan varias restricciones, se deben admitir todas las restricciones para satisfacer la consulta.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado functiondiscoveryapi.h
Archivo DLL FunDisc.dll

Consulte también

Consultas de detección de funciones

IFunctionInstanceCollectionQuery

  • Last updated on