IFunctionInstanceCollectionQuery::AddPropertyConstraint-Methode (functiondiscoveryapi.h)

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

Fügt der Abfrage eine Eigenschaftseinschränkung hinzu.

Diese Methode beschränkt Abfrageergebnisse auf Funktionsinstanzen mit einem Eigenschaftenschlüssel (PKEY), der der angegebenen Einschränkung entspricht.

Syntax

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

Parameter

[in] Key

Der Eigenschaftenschlüssel (PKEY) für die Einschränkung. Weitere Informationen zu PKEYs finden Sie unter Schlüsseldefinitionen.

[in] pv

Ein PROPVARIANT , der für die Einschränkung verwendet wird. Dieser Typ muss mit dem PROPVARIANT-Typ übereinstimmen, der Schlüssel zugeordnet ist.

Im Folgenden werden mögliche Werte veranschaulicht. Beachten Sie, dass nur eine Teilmenge der PROPVARIANT-Typen, die von den integrierten Anbietern unterstützt werden, als Eigenschaftseinschränkung verwendet werden kann.

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

Ein PropertyConstraint-Wert, der den Typ des Vergleichs angibt, der verwendet werden soll, wenn der PKEY der Einschränkung mit der Funktion instance PKEY verglichen wird.

Rückgabewert

Mögliche Rückgabewerte sind u. a. die folgenden:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Die für die Abfrage angegebene Einschränkung wird nicht unterstützt. Entweder wird die Einschränkung für einen bestimmten VARENUM-Typ nicht unterstützt, oder der VARENUM-Typ wird überhaupt nicht unterstützt.

Hinweise

Eine Funktion instance stimmt nur mit einer Eigenschaftseinschränkung überein, wenn der PROPVARIANT-Typ der Funktion instance PKEY mit dem PROPVARIANT-Typ des PKEY der Einschränkung übereinstimmt und der PKEY-Wert der Funktion instance mit dem PKEY-Wert der Einschränkung übereinstimmt, indem der durch enumPropertyConstraint angegebene Vergleichsoperator verwendet wird.

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

Anforderungen

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

Funktionsermittlungsabfragen

IFunctionInstanceCollectionQuery