IFunctionInstanceCollectionQuery::AddQueryConstraint-Methode (functiondiscoveryapi.h)

[Funktionsermittlung ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die AddQueryConstraint-Methode fügt der Abfrage eine Abfrageeinschränkung hinzu.

Mit dieser Methode kann die Anwendung das Resultset nur auf die Instanzen filtern, die diese Einschränkung erfüllen.

Syntax

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

Parameter

[in] pszConstraintName

Die Abfrageeinschränkung.

[in] pszConstraintValue

Der Einschränkungswert.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.

Hinweise

Wenn mehrere Einschränkungen hinzugefügt werden, müssen alle Einschränkungen unterstützt werden, um die Abfrage zu erfüllen.

AddQueryConstraint schlägt mit einem Fehler fehl, wenn das IFunctionInstanceCollectionQuery-Objekt alle Unterkategorien enthält und die AddQueryConstraint-Methode aufgerufen wird, wobei der pszConstraintName-Parameter auf FD_QUERYCONSTRAINT_PROVIDERINSTANCEID festgelegt ist. Um diesen Fehler zu vermeiden, erstellen Sie ein IFunctionInstanceCollectionQuery-Objekt , das nicht alle Unterkategorien enthält. Sie können ein solches Objekt erstellen, indem Sie CreateInstanceCollectionQuery aufrufen, wobei der fIncludeAllSubCategories-Parameter auf false festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	functiondiscoveryapi.h
DLL	FunDisc.dll

Weitere Informationen

Einschränkungsdefinitionen

Funktionsermittlungsabfragen

IFunctionInstanceCollectionQuery