Метод IUPnPDeviceControl::Initialize (upnphost.h)
Метод Initialize используется для инициализации устройства. Узел устройства вызывает этот метод.
Синтаксис
HRESULT Initialize(
[in] BSTR bstrXMLDesc,
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrInitString
);
Параметры
[in] bstrXMLDesc
Указывает полное описание устройства XML, опубликованное узлом устройства. Описание устройства основано на шаблоне, предоставленном устройством.
[in] bstrDeviceIdentifier
Идентифицирует инициализируемое устройство. Это тот же идентификатор, возвращенный IUPnPRegistrar::RegisterDevice или IUPnPRegistrar::RegisterRunningDevice. Он также используется для получения определяемого пользователем имени устройства с помощью IUPnPRegistrar::GetUniqueDeviceName.
[in] bstrInitString
Указывает строку инициализации, используемую при регистрации этого устройства.
Возвращаемое значение
При реализации этого метода верните S_OK, если метод выполнен успешно. В противном случае возвращается один из кодов com-ошибок, определенных в WinError.h.
Комментарии
Этот метод вызывается сразу после создания экземпляра объекта управления устройством. Его необходимо вызвать перед вызовом IUPnPDeviceControl::GetServiceObject .
Разница между работающим и неработающего устройствами заключается в том, что вызывается метод Initialize .
Для работающих устройств метод Initialize вызывается при вызове IUPnPRegistrar::RegisterRunningDevice , а инициализация завершается до возврата IUPnPRegistrar::RegisterRunningDevice .
Для неработающих устройств метод Initialize не обязательно вызывается при вызове IUPnPRegistrar::RegisterDevice . Initialize вызывается при поступлении первого запроса элемента управления или события.
BstrDeviceIdentifier также можно использовать для вызова IUPnPRegistrar::GetUniqueDeviceName.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnphost.h |
| DLL | Upnphost.dll |