IWSDiscoveryProviderNotify::SearchFailed-Methode (wsddisco.h)

Wird aufgerufen, um anzugeben, dass eine vom Benutzer initiierte Suche fehlgeschlagen ist.

Syntax

HRESULT SearchFailed(
  [in]           HRESULT hr,
  [in, optional] LPCWSTR pszTag
);

Parameter

[in] hr

Ursache des Suchfehlers, der diesen Rückruf initiiert hat. Der Wert S_FALSE gibt an, dass die Suche abgeschlossen wurde, ohne Rückrufe hinzufügen auszugeben.

[in, optional] pszTag

Optionales Bezeichnertag für diese Suche. Kann NULL sein.

Rückgabewert

Der Rückgabewert ist nicht sinnvoll. Ein Implementierer sollte S_OK zurückgeben.

Hinweise

SearchComplete wird aufgerufen, wenn Antworten erfolgreich empfangen wurden.

SearchFailed wird aufgerufen, wenn eine vom Benutzer initiierte Abfrage nicht zu einer Antwort führt. In diesem Fall wird der Wert des hr-Parameters S_FALSE. SearchFailed kann optional aufgerufen werden, wenn bei der versuchten Übertragung der Abfrage Fehler auftreten, da die Abfrageübertragung nicht unbedingt synchron ist. pszTag entspricht dem vom Benutzer bereitgestellten Tag aus der Abfrage und sollte verwendet werden, um zu identifizieren, welche Abfrage fehlgeschlagen ist.

Das Intervall zwischen dem Initiieren der Suche mit SearchByType oder SearchById und dem Empfangen einer SearchFailed-Benachrichtigung beträgt maximal 10 Sekunden, basierend auf MATCH_TIMEOUT aus WS-Discovery und geändert durch den DPWS-Anhang I. Das Intervall zwischen dem Initiieren der Suche mit SearchByAddress und dem Empfang einer SearchFailed-Benachrichtigung beträgt in der Regel 21 Sekunden, kann jedoch maximal 150 Sekunden betragen.

Anforderungen

Weitere Informationen

IWSDiscoveryProviderNotify