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

Ruft die angegebene Funktion instance basierend auf dem Bezeichner ab.

Syntax

HRESULT GetInstance(
  [in]  const WCHAR       *pszFunctionInstanceIdentity,
  [out] IFunctionInstance **ppIFunctionInstance
);

Parameter

[in] pszFunctionInstanceIdentity

Der Bezeichner der Funktion instance (siehe GetID).

[out] ppIFunctionInstance

Ein Zeiger auf einen IFunctionInstance-Schnittstellenzeiger , der verwendet wird, um die Schnittstelle zurückzugeben.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Der Wert von pszFunctionInstanceIdentity ist ungültig.
E_OUTOFMEMORY	Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen.
HRESULT_FROM_WIN32(ERROR_OBJECT_NOT_FOUND) 0x800710d8	Die Funktion instance, die durch die angegebene ID dargestellt wird, ist auf diesem Computer nicht vorhanden.
E_PENDING	Der Aufruf wurde für einen Anbieter ausgeführt, der Ergebnisse asynchron zurückgibt.

Hinweise

Einige Funktionsermittlungsanbieter geben ihre Abfrageergebnisse mit der IFunctionDiscoveryNotification-Schnittstelle zurück. GetInstance findet keine Funktionsinstanzen, die auf diese Weise zurückgegeben werden, und schlägt mit E_PENDING fehl. Es wird empfohlen, dass Clients die CreateInstanceQuery-Methode der IFunctionDiscovery-Schnittstelle verwenden, um Funktionsinstanzen für solche Anbieter zu finden.

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

IFunctionDiscovery