IUPnPDeviceFinder::FindByType-Methode (upnp.h)
Die FindByType-Methode sucht synchron nach Geräten nach Gerätetyp oder Diensttyp.
Syntax
HRESULT FindByType(
[in] BSTR bstrTypeURI,
[in] DWORD dwFlags,
[out] IUPnPDevices **pDevices
);
Parameter
[in] bstrTypeURI
Gibt den Typ-URI für das Gerät oder den Diensttyp an, nach dem gesucht werden soll.
[in] dwFlags
Muss Null sein. Dieser Parameter ist für die zukünftige Verwendung reserviert.
[out] pDevices
Empfängt einen Verweis auf eine Sammlung gefundener IUPnPDevices-Geräte .
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Diese Methode wird erst zurückgegeben, wenn die Suche abgeschlossen ist. Die Suche kann mindestens neun Sekunden und möglicherweise mehr dauern. Diese Methode darf nicht über einen Thread aufgerufen werden, der Benutzeroberflächenmeldungen verarbeitet.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |