IUPnPDevice::get_SerialNumber-Methode (upnp.h)
Die SerialNumber-Eigenschaft gibt eine lesbare Form der Seriennummer des Geräts an.
Syntax
HRESULT get_SerialNumber(
[out] BSTR *pbstr
);
Parameter
[out] pbstr
Empfängt einen Verweis auf eine Zeichenfolge, die die Seriennummer enthält. Geben Sie diese Zeichenfolge mit SysFreeString frei, wenn sie nicht mehr verwendet wird. Diese Eigenschaft ist optional, und das Gerät verfügt möglicherweise nicht über eine Seriennummer.
Rückgabewert
Für C++: Wenn die Get-Methode dieser Eigenschaft erfolgreich ist, wird der Rückgabewert S_OK. Wenn das Gerät keine Seriennummer angegeben hat, lautet der Rückgabewert S_FALSE. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.
Hinweise
Diese Eigenschaft ist optional, und pbstr kann NULL sein.
Es ist möglich, dass mehrere Geräte dieselbe Seriennummer haben. Verwenden Sie den eindeutigen Gerätenamen, um zu ermitteln, ob zwei Geräteobjekte dasselbe Gerät beschreiben. Weitere Informationen finden Sie unter UniqueDeviceName.
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 |