IWSDiscoveryProvider::SearchByAddress-Methode (wsddisco.h)

  • Artikel

Initialisiert eine Suche nach WS-Discovery-Hosts nach Geräteadresse.

Syntax

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

Parameter

[in] pszAddress

Die HTTP-Transportadresse des Geräts.

[in, optional] pszTag

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

Rückgabewert

Mögliche Rückgabewerte sind unter anderem:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
 pszAddress ist NULL, die Länge in Den Zeichen von pszAddress überschreitet WSD_MAX_TEXT_LENGTH (8192), oder die Länge in Den Zeichen von pszTag überschreitet WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 Eine Rückrufschnittstelle wurde nicht angefügt. Sie müssen Attach aufrufen, bevor Sie diese Methode aufrufen.
E_OUTOFMEMORY
 Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

SearchByAddress initiiert einen WS-Discovery Test über HTTP, um ein Gerät an einer bekannten URL zu identifizieren. Der Test wird an die von pszAddress angegebene Adresse gesendet. Dieser Aufruf kann zu einem oder mehreren Add-Rückrufen führen. Wenn Add-Rückrufe ausgegeben werden, bevor die Suche abgeschlossen ist, wird ein SearchComplete-Rückruf ausgegeben. Andernfalls wird ein SearchFailed-Rückruf ausgegeben. Das Intervall zwischen dem Initiieren der Suche und dem Empfang einer dieser Benachrichtigungen kann bis zu 30 Sekunden betragen.

pszTag ist eine optionale vom Benutzer bereitgestellte Zeichenfolge, die in beiden Rückrufen zurückgespeist wird, sodass der Aufrufer den Rückruf der ursprünglichen Abfrage zuordnen kann.

Informationen zur Problembehandlung bei Anwendungen, die diese Methode aufrufen, finden Sie unter Problembehandlung für WSDAPI-Anwendungen.

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 wsddisco.h (einschließen von Wsdapi.h)
DLL Wsdapi.dll

Weitere Informationen

IWSDiscoveryProvider