Metodo IFunctionInstanceCollectionQuery::AddPropertyConstraint (functiondiscoveryapi.h)

[Individuazione funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Aggiunge un vincolo di proprietà alla query.

Questo metodo limita i risultati della query solo alle istanze di funzione con una chiave di proprietà (PKEY) corrispondente al vincolo specificato.

Sintassi

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

Parametri

[in] Key

Chiave di proprietà (PKEY) per il vincolo. Per altre informazioni su PKEYs, vedere Definizioni delle chiavi.

[in] pv

Oggetto PROPVARIANT usato per il vincolo. Questo tipo deve corrispondere al tipo PROPVARIANT associato a Key.

Di seguito sono illustrati i valori possibili. Si noti che solo un subset dei tipi PROPVARIANT supportati dai provider predefiniti può essere usato come vincolo di proprietà.

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

Valore PropertyConstraint che specifica il tipo di confronto da usare durante il confronto tra PKEY del vincolo e PKEY dell'istanza della funzione.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati a, quanto segue.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Il vincolo specificato per la query non è supportato. Il vincolo non è supportato per un tipo VARENUM specifico o il tipo VARENUM non è supportato.

Commenti

Un'istanza di funzione corrisponderà solo a un vincolo di proprietà quando il tipo PKEY dell'istanza della funzione corrisponde al tipo PKEY del vincolo e al valore PKEY dell'istanza della funzione corrisponde al valore PKEY del vincolo usando l'operatore di confronto specificato da enumPropertyConstraint.

Se vengono aggiunti più vincoli, tutti i vincoli devono essere supportati per soddisfare la query.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

Query di individuazione delle funzioni

IFunctionInstanceCollectionQuery