IUPnPRegistrar::GetUniqueDeviceName (Windows Embedded CE 6.0)

1/6/2010

This method retrieves the UDN that was generated for the device by the device host. The UDNs specified for devices in the device description template are replaced with globally unique UDNs during registration.

Syntax

HRESULT GetUniqueDeviceName(
  BSTR bstrDeviceIdentifier,
  BSTR bstrTemplateUDN,
  BSTR* pbstrUDN
);

Parameters

• bstrDeviceIdentifier
  [in] Specifies the identifier returned from a call to IUpnPRegistrar::RegisterDevice or IUPnPRegistrar::RegisterRunningDevice.

• bstrTemplateUDN
  [in] Specifies the UDN listed in the device description template.

• pbstrUDN
  [out] Specifies a pointer to the device UDN that was generated by the device host.

Return Value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes that are defined in Winerror.h.

Requirements

See Also

Reference

IUPnPRegistrar
IUPnPRegistrar::RegisterDevice
IUPnPRegistrar::RegisterRunningDevice