Метод IUPnPRegistrar::GetUniqueDeviceName (upnphost.h)
Метод GetUniqueDeviceName извлекает UDN для указанного устройства. Определяемое пользователем имя было создано узлом устройства для каждого внедренного устройства. Имя пользователя шаблона в описании устройства заменяется созданным UDN для каждого внедренного устройства при регистрации устройства. Этот метод является повторным входным.
Синтаксис
HRESULT GetUniqueDeviceName(
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrTemplateUDN,
[out] BSTR *pbstrUDN
);
Параметры
[in] bstrDeviceIdentifier
Указывает идентификатор, возвращаемый методом RegisterDevice или RegisterRunningDevice.
[in] bstrTemplateUDN
Указывает имя пользователя из шаблона описания устройства.
[out] pbstrUDN
Получает имя пользователя устройства, созданное узлом устройства.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.
Комментарии
Каждое UDN, указанное для устройства в шаблоне описания устройства, заменяется во время регистрации. Узел устройства заменяет каждое UDN глобально уникальным.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnphost.h |
| DLL | Upnphost.dll |