Metodo IFunctionInstanceCollectionQuery::AddQueryConstraint (functiondiscoveryapi.h)

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

Il metodo AddQueryConstraint aggiunge un vincolo di query alla query.

Questo metodo consente all'applicazione di filtrare il set di risultati solo per quelle istanze che soddisfano questo vincolo.

Sintassi

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

Parametri

[in] pszConstraintName

Vincolo di query.

[in] pszConstraintValue

Valore del vincolo.

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.

Commenti

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

AddQueryConstraint avrà esito negativo se l'oggetto IFunctionInstanceCollectionQuery include tutte le sottocategorie e il metodo AddQueryConstraint viene chiamato con il parametro pszConstraintName impostato su FD_QUERYCONSTRAINT_PROVIDERINSTANCEID. Per evitare questo errore, creare un oggetto IFunctionInstanceCollectionQuery che non include tutte le sottocategorie. È possibile creare un oggetto di questo tipo chiamando CreateInstanceCollectionQuery con il parametro fIncludeAllSubCategories impostato su false.

Requisiti

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

Definizioni dei vincoli

Query di individuazione delle funzioni

IFunctionInstanceCollectionQuery