IUPnPRegistrar::GetUniqueDeviceName-Methode (upnphost.h)

Die GetUniqueDeviceName-Methode ruft den UDN für das angegebene Gerät ab. Der UDN wurde vom Gerätehost für jedes eingebettete Gerät generiert. Die Vorlage UDN in der Gerätebeschreibung wird durch diesen generierten UDN für jedes eingebettete Gerät ersetzt, wenn das Gerät registriert wird. Diese Methode wird erneut verwendet.

Syntax

HRESULT GetUniqueDeviceName(
  [in]  BSTR bstrDeviceIdentifier,
  [in]  BSTR bstrTemplateUDN,
  [out] BSTR *pbstrUDN
);

Parameter

[in] bstrDeviceIdentifier

Gibt den von RegisterDevice oder RegisterRunningDevice zurückgegebenen Bezeichner an.

[in] bstrTemplateUDN

Gibt den UDN aus der Gerätebeschreibungsvorlage an.

[out] pbstrUDN

Empfängt den UDN des Geräts, der vom Gerätehost generiert wurde.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.

Hinweise

Jeder UDN, der für ein Gerät in der Gerätebeschreibungsvorlage angegeben ist, wird während der Registrierung ersetzt. Der Gerätehost ersetzt jeden UDN durch einen global eindeutigen.

Anforderungen

Weitere Informationen

IUPnPRegistrar