IWSDDeviceHost::AddDynamicService (Compact 2013)

3/26/2014

This method registers a service object for incoming requests, but does not add the service to the device host metadata. This is used for transient (dynamic) services.

Syntax

HRESULT AddDynamicService(
  LPCWSTR pszServiceId,
  LPCWSTR pszEndpointAddress,
  const WSD_PORT_TYPE* pPortType,
  const WSDXML_NAME* pPortName,
  const WSDXML_ELEMENT* pAny,
  IUnknown* pService
);

Parameters

• pszServiceId
  [in] The ID for the dynamic service. The service ID should be distinct from all the service IDs in the service host metadata and from any other registered dynamic service. The pszServiceId must be a URI.

• pszEndpointAddress
  [in, optional] An optional URI to use as the endpoint address for this service. If none is specified, the device host will assume the service should be available on all local transport addresses.

• pPortType
  [in, optional] Reference to a WSD_PORT_TYPE structure that specifies the port type. May be NULL. Specify only one of pPortType and pPortName.

• pPortName
  [in, optional] Reference to a WSDXML_NAME structure that specifies the type of the service, with associating the service with a specified port. Specify only one of pPortType and pPortName.

• pAny
  [in, optional] Optional reference to an extensible section to be included in the dynamic service metadata.

• pService
  [in, optional] Optional reference to a host service object to register.

Return Value

The following table shows the possible error code return values.

Remarks

When this method is called, the device adds a reference to the service object and calls its methods in response to request messages addressed to the service. Call the IWSDDeviceHost::RemoveDynamicService method on the device host to release its reference to the service and stop calling methods on the service.

Requirements

See Also

Reference

IWSDDeviceHost
Web Services on Devices Interfaces