IUPnPRegistrar::GetUniqueDeviceName

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.

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Upnphost.h.
Link Library: Uuid.lib.

See Also

IUpnPRegistrar::RegisterDevice | IUPnPRegistrar::RegisterRunningDevice

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.