IFunctionDiscoveryNotification::OnError-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.]

Empfängt Fehler, die während der asynchronen Abfrageverarbeitung auftreten.

Syntax

HRESULT OnError(
  [in] HRESULT        hr,
  [in] FDQUERYCONTEXT fdqcQueryContext,
  [in] const WCHAR    *pszProvider
);

Parameter

[in] hr

Der gemeldete Abfragefehler.

[in] fdqcQueryContext

Der für die Änderungsbenachrichtigung registrierte Kontext. Der Typ FDQUERYCONTEXT wird als DWORDLONG definiert.

[in] pszProvider

Der Name des Anbieters.

Rückgabewert

Die Implementierung der OnError-Methode im Clientprogramm sollte einen der folgenden HRESULT-Werte an den Aufrufer zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Der Wert eines der Eingabeparameter ist ungültig.

Hinweise

In der Regel erwarten Clients, dass jeder asynchrone Fehler schwerwiegend ist und dass die Abfrage keine Ergebnisse mehr zurückgibt, aber die dokumentation des benutzerdefinierten Anbieters kann für bestimmte Fehlercodes darauf hinweisen.

Rufen Sie Release nicht für das Abfrageobjekt aus dieser Methode auf. Dies kann zu einem Deadlock führen. Wenn Release für ein Abfrageobjekt aus einem anderen Thread aufgerufen wird, während ein Rückruf ausgeführt wird, wird das Objekt erst freigegeben, wenn der Rückruf abgeschlossen ist.

Alle Benachrichtigungen, die von Anbietern an die Funktionsermittlung übergeben werden, werden in die Warteschlange eingereiht und einzeln an den Client zurückgegeben. Rückrufe werden synchronisiert, sodass ein Client nur jeweils eine Benachrichtigung erhält.

Da andere IFunctionDiscoveryNotification-Methodenaufrufe in anderen Threads vorgenommen werden können, müssen alle Änderungen, die während des Aufrufs am Threadzustand vorgenommen wurden, wiederhergestellt werden, bevor die Methode beendet wird.

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

Weitere Informationen

IFunctionDiscoveryNotification