IUPnPDevice::get_FriendlyName-Methode (upnp.h)
Die FriendlyName-Eigenschaft gibt den Geräteanzeigenamen für das Gerät an.
Syntax
HRESULT get_FriendlyName(
[out] BSTR *pbstr
);
Parameter
[out] pbstr
Empfängt einen Verweis auf eine Zeichenfolge, die den Geräteanzeigenamen enthält. Geben Sie diese Zeichenfolge mit SysFreeString frei, wenn sie nicht mehr benötigt wird.
Rückgabewert
Für C++: Wenn die "get"-Methode dieser Eigenschaft erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Es ist möglich, dass mehrere Geräte denselben Anzeigenamen haben. Um zu ermitteln, ob zwei Geräteobjekte dasselbe Gerät beschreiben, verwenden Sie den eindeutigen Gerätenamen. Weitere Informationen finden Sie unter UniqueDeviceName.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |