Share via

IWSDDeviceHost::Start (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method starts the device host and publishes the device host using a WS-Discovery Hello message. If a notification sink is passed to this method, then the notification sink is also registered. After Start has been called successfully, the device host will automatically respond to Probe and Resolve messages.

Syntax

HRESULT Start(
  ULONGLONG ullInstanceId,
  const WSD_URI_LIST* pScopeList,
  IWSDDeviceHostNotify* pNotificationSink
);

Parameters

  • ullInstanceId
    [in] The instance identifier. If no identifier is provided, the current instance value + 1 is used as the default.

    Note

    For compatibility with the WS-Discovery specification, this value must be less than or equal to UINT_MAX (4294967295).

  • pScopeList
    [in] Scope of the device host. If NULL, no scopes are associated with the host.
  • pNotificationSink
    [in, optional] Reference to an IWSDDeviceHostNotify object that specifies the notification sink.

Return Value

The following table shows the possible error code return values.

Error code Description

S_OK

This method completed successfully.

S_FALSE

The device host has already been started.

E_FAIL

The method failed. It may have failed because the host has not been initialized. Call IWSDDeviceHost::Init to initialize a device host.

E_ABORT

There is no metadata associated with the host.

Requirements

Header wsdapi.h
Library wsdapi.lib
Windows Embedded CE Windows Embedded CE 6.0 R2

See Also

Reference

IWSDDeviceHost
Web Services on Devices Interfaces