IWSDiscoveryProvider::SearchByType-Methode (wsddisco.h)

  • Artikel

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

Syntax

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Parameter

[in, optional] pTypesList

Zeiger auf eine WSD_NAME_LIST-Struktur , die die Liste der Suchanbietertypen darstellt, nach denen gesucht werden soll. Kann NULL sein.

[in, optional] pScopesList

Zeiger auf eine WSD_URI_LIST-Struktur , die die Liste der Suchanbieterbereiche darstellt, nach denen gesucht werden soll. Kann NULL sein.

[in, optional] pszMatchBy

Übereinstimmungsregel, die für Bereiche verwendet wird. Kann NULL sein.

[in, optional] pszTag

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

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
 Die Länge in Zeichen von pszMatchBy überschreitet WSD_MAX_TEXT_LENGTH (8192) oder die Länge in Zeichen von pszTag über 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

SearchByType initiiert einen WS-Discovery-Test , um Ermittlungshosts zu finden, die den angegebenen Kriterien entsprechen. Diese Methode ermöglicht den Abgleich nach Typen, Bereichen, einer Kombination der beiden oder dem Abgleich aller ermittlungsfähigen Geräte (wenn keine Bereiche oder Typen bereitgestellt werden).

pszMatchBy sollte nur bereitgestellt werden, wenn pScopesList ebenfalls bereitgestellt wird. Dieser Aufruf kann zu einem oder mehreren Rückrufen hinzufügen führen. Wenn Rückrufe hinzufügen ausgegeben werden, bevor die Suche abgeschlossen ist, wird ein SearchComplete-Rückruf ausgegeben. andernfalls wird ein SearchFailed-Rückruf ausgegeben.

pszTag ist eine optionale vom Benutzer bereitgestellte Zeichenfolge, die in jedem Rückruf zurückgegeben 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 bei 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