IUPnPDevice::get_UPC method (upnp.h)

The UPC property specifies a human-readable form of the product code.

Syntax

HRESULT get_UPC(
  [out] BSTR *pbstr
);

Parameters

[out] pbstr

Receives a reference to a string that contains the product code. Release this string with SysFreeString when it is no longer required. If the device does not specify a product code, this parameter receives an empty string.

Return value

For C++: If this property's "get" method succeeds, the return value is S_OK. If the device did not specify a product code, 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 product code. 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