IFunctionDiscovery::CreateInstanceQuery-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.]

Erstellt eine Abfrage für eine bestimmte Funktion instance.

Syntax

HRESULT CreateInstanceQuery(
  [in]      const WCHAR                    *pszFunctionInstanceIdentity,
  [in]      IFunctionDiscoveryNotification *pIFunctionDiscoveryNotification,
  [in, out] FDQUERYCONTEXT                 *pfdqcQueryContext,
  [out]     IFunctionInstanceQuery         **ppIFunctionInstanceQuery
);

Parameter

[in] pszFunctionInstanceIdentity

Der Bezeichner der Funktion instance.

[in] pIFunctionDiscoveryNotification

Ein Zeiger auf die IFunctionDiscoveryNotification-Schnittstelle, die von der aufrufenden Anwendung implementiert wird. Falls angegeben, wird der Benachrichtigungsprozess zur Funktionsermittlung aktiviert. Dieser Parameter kann NULL sein. dies ist jedoch für Netzwerkanbieter erforderlich.

[in, out] pfdqcQueryContext

Ein Zeiger auf den Kontext, in dem die Abfrage erstellt wurde. Der Typ FDQUERYCONTEXT wird als DWORDLONG definiert.

[out] ppIFunctionInstanceQuery

Ein Zeiger auf einen IFunctionInstanceQuery-Schnittstellenzeiger , der verwendet wird, um die generierte Abfrage zurückzugeben.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

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

Hinweise

Funktionsermittlung Netzwerkanbieter geben Instanzen nur über die IFunctionDiscoveryNotification-Schnittstelle zurück.

Diese Methode initialisiert nur den Abfrageaufruf. Die Execute-Methode der IFunctionInstanceQuery-Schnittstelle , die in ppIFunctionInstanceQuery zurückgegeben wird, muss aufgerufen werden, um die Abfrage auszuführen und alle Daten zurückzugeben.

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

Funktionsermittlungsabfragen

IFunctionDiscovery