IUPnPRegistrar::RegisterRunningDevice (Windows CE 5.0)
This method registers a running device with the device host framework and returns a device identifier that must be used to unregister or reregister the device. After being registered with the device host framework, the device is published on the network.
RegisterRunningDevice(BSTRbstrXMLDesc,IUnknown* punkDeviceControl,BSTR bstrInitString,BSTR bstrResourcePath,LONG nLifeTime,BSTR* pbstrDeviceIdentifier);
Parameters
- bstrXMLDesc
[in] Specifies the XML device description template. - punkDeviceControl
[in] Specifies a pointer to an IUnknown interface to the device's device control class. - bstrInitString
[in] Specifies the device-specific initialization string that gets passed to the IUPnPDeviceControl::Initialize method. - bstrResourcePath
[in] Specifies the location of the resource directory of the device. This resource directory contains the icon files and service descriptions that are specified in the device description template. - nLifeTime
[in] Specifies the SSDP timeout (in seconds) of the device after which the announcements will be refreshed. - pbstrDeviceIdentifier
[out] Pointer to the device identifier that will be used to unregister or reregister the device.
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
IUPnPDeviceControl | IUPnPDeviceControl::Initialize
Send Feedback on this topic to the authors