Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[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.]
Erstellt eine Abfrage für eine Auflistung bestimmter Funktionsinstanzen.
Syntax
HRESULT CreateInstanceCollectionQuery(
[in] const WCHAR *pszCategory,
[in] const WCHAR *pszSubCategory,
[in] BOOL fIncludeAllSubCategories,
[in] IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
[in, out] FDQUERYCONTEXT *pfdqcQueryContext,
[out] IFunctionInstanceCollectionQuery **ppIFunctionInstanceCollectionQuery
);
Parameter
[in] pszCategory
Die Kategorie für die Abfrage. Weitere Informationen finden Sie unter Kategoriedefinitionen.
[in] pszSubCategory
Die Unterkategorie für die Abfrage. Siehe Unterkategoriedefinitionen. Dieser Parameter kann NULL sein.
Unterkategorieabfragen werden nur für Mehrschichtkategorien und einige Anbieterkategorien unterstützt. Der Registrierungsanbieter, der PnP-X-Zuordnungsanbieter und der Veröffentlichungsanbieter unterstützen Unterkategorieabfragen. Benutzerdefinierte Anbieter können explizit so konzipiert werden, dass sie Unterkategorieabfragen unterstützen. Dies bedeutet, dass der pszSubCategory-Parameter nur dann auf einen Wert ohne NULL festgelegt werden sollte, wenn der pszCategory-Parameter auf FCTN_CATEGORY_REGISTRY, FCTN_CATEGORY_PUBLICATION, FCTN_CATEGORY_PNPXASSOCIATION oder einen benutzerdefinierten Kategoriewert festgelegt ist, der entweder für eine mehrschichtige Kategorie oder einen benutzerdefinierten Anbieter definiert ist, der Unterkategorienabfragen unterstützt.
[in] fIncludeAllSubCategories
Wenn TRUE, erstellt diese Methode rekursiv eine Abfrage für alle Unterkategorien der in pszCategory angegebenen Kategorie, und gibt eine Auflistung zurück, die Funktionsinstanzen aus allen Unterkategorien von pszCategory enthält.
Wenn FALSE, schränkt diese Methode die erstellte Abfrage auf die Rückgabe von Funktionsinstanzen in der kategorie ein, die von pszCategory und der von pszSubCategory angegebenen Unterkategorie angegeben wird.
[in] pIFunctionDiscoveryNotification
Ein Zeiger auf die IFunctionDiscoveryNotification-Schnittstelle, die von der aufrufenden Anwendung implementiert wird. Dieser Parameter kann NULL sein. Dieser Zeiger ist gültig, bis das zurückgegebene Abfrageobjekt freigegeben wird.
[in, out] pfdqcQueryContext
Ein Zeiger auf den Kontext, in dem die Abfrage erstellt wurde. Der Typ FDQUERYCONTEXT wird als DWORDLONG definiert.
[out] ppIFunctionInstanceCollectionQuery
Ein Zeiger auf den IFunctionInstanceCollectionQuery-Schnittstellenzeiger .
Rückgabewert
Mögliche Rückgabewerte sind unter anderem folgendes:
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der Wert von pszCategory oder pIID ist ungültig. Der wert, der im ppIFunctionInstanceCollectionQuery-Parameter zurückgegeben wird, ist NULL. |
|
Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen. |
|
Der Wert von pszCategory oder pszSubCategory ist unbekannt. |
Hinweise
Wenn pIFunctionDiscoveryNotification angegeben ist, wird der Benachrichtigungsprozess zur Funktionsermittlung aktiviert. Dieser Parameter kann NULL sein. Dies ist jedoch für Netzwerkanbieter erforderlich, da sie keine synchronen Ergebnisse zurückgeben. Funktionsermittlungsnetzwerkanbieter geben Instanzen nur über die IFunctionDiscoveryNotification-Schnittstelle zurück.
Diese Methode initialisiert nur den Abfrageaufruf. Die Execute-Methode der IFunctionInstanceCollectionQuery-Schnittstelle , die in ppIFunctionInstanceCollectionQuery zurückgegeben wird, muss aufgerufen werden, um die Abfrage auszuführen und alle Daten zurückzugeben.
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 |