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

See also

IUPnPDevice

IUPnPDevice::UniqueDeviceName