IUPnPDevice::get_UPC-Methode (upnp.h)
Die UPC-Eigenschaft gibt eine lesbare Form des Produktcodes an.
Syntax
HRESULT get_UPC(
[out] BSTR *pbstr
);
Parameter
[out] pbstr
Empfängt einen Verweis auf eine Zeichenfolge, die den Produktcode enthält. Geben Sie diese Zeichenfolge mit SysFreeString frei, wenn sie nicht mehr benötigt wird. Wenn das Gerät keinen Produktcode angibt, empfängt dieser Parameter eine leere Zeichenfolge.
Rückgabewert
Für C++: Wenn die "get"-Methode dieser Eigenschaft erfolgreich ist, wird der Rückgabewert S_OK. Wenn das Gerät keinen Produktcode angegeben hat, wird der Rückgabewert S_FALSE. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Diese Eigenschaft ist optional und pbstr kann NULL sein.
Es ist möglich, dass mehrere Geräte denselben Produktcode 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 |