IUPnPDevice::get_SerialNumber method (upnp.h)
The SerialNumber property specifies a human-readable form of the serial number of the device.
Syntax
HRESULT get_SerialNumber(
[out] BSTR *pbstr
);
Parameters
[out] pbstr
Receives a reference to a string that contains the serial number. Release this string with SysFreeString when it is no longer used. This property is optional and the device may not have a serial number.
Return value
For C++: If this property's "get" method succeeds, the return value is S_OK. If the device did not specify a serial number, the return value is S_FALSE. Otherwise, the method returns one of the COM error codes defined in WinError.h.
Remarks
This property is optional and pbstr may be NULL.
It is possible for multiple devices to have the same serial number. To determine if two device objects describe the same device, use the unique device name. For more information, see UniqueDeviceName.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | None supported |
Target Platform | Windows |
Header | upnp.h |
DLL | Upnp.dll |