IWSDiscoveryProvider::SearchById-Methode (wsddisco.h)
Initialisiert eine Suche nach WS-Discovery-Hosts nach Gerätebezeichner.
Syntax
HRESULT SearchById(
[in] LPCWSTR pszId,
[in, optional] LPCWSTR pszTag
);
Parameter
[in] pszId
Gerätebezeichner des gewünschten Ermittlungsanbieters.
[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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
pszId ist NULL, die Länge in Zeichen von pszId überschreitet WSD_MAX_TEXT_LENGTH (8192), oder die Länge in Zeichen von pszTag überschreitet WSD_MAX_TEXT_LENGTH (8192). |
|
Eine Rückrufschnittstelle wurde nicht angefügt. Sie müssen Attach aufrufen, bevor Sie diese Methode aufrufen. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
SearchById initiiert eine WS-Discovery Resolve , um ein zuvor bekanntes bestimmtes Gerät zu finden. pszId wird als Endpunktadresse in der Auflösung verwendet. 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
| 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 |