Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method returns a human-readable form of the serial number of the device.

Syntax 

HRESULT get_SerialNumber(
  BSTR* 
pbstr
);

Parameters

pbstr

[out] Receives a reference to a string that contains the serial number. This string must be released when it is no longer needed. If the device does not specify a serial number, this parameter receives an empty string.

Return Value

S_OK

This method was successful.

Otherwise, the method returns one of the COM error codes defined in WinError.h.

Remarks

This property is optional and can return 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 IUPnPDevice::UniqueDeviceName.

Requirements

Header upnp.h
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also