Метод IUPnPDeviceControl::GetServiceObject (upnphost.h)
Метод GetServiceObject используется для получения указателя IDispatch на определенный объект службы. Узел устройства вызывает этот метод один раз для каждой службы, при первом получении запроса на службу.
Синтаксис
HRESULT GetServiceObject(
[in] BSTR bstrUDN,
[in] BSTR bstrServiceId,
[out] IDispatch **ppdispService
);
Параметры
[in] bstrUDN
Указывает определяемый пользователем идентификатор устройства.
[in] bstrServiceId
Указывает идентификатор службы, для которой требуется получить указатель.
[out] ppdispService
Получает указатель IDispatch на объект службы.
Возвращаемое значение
При реализации этого метода верните S_OK, если метод выполнен успешно. В противном случае возвращается один из кодов com-ошибок, определенных в WinError.h.
Комментарии
Этот метод вызывается узлом устройства при получении запроса на управление или подписки на события для определенной службы.
Встроенные устройства различаются по определяемым пользователем именам.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnphost.h |
| DLL | Upnphost.dll |