Método IWSDDeviceHost::Start (wsdhost.h)

Inicia el host del dispositivo y publica el host de dispositivo mediante un mensaje de WS-Discovery Hello. Si se pasa un receptor de notificaciones a este método, el receptor de notificaciones también se registra. Una vez que se haya llamado a Start correctamente, el host del dispositivo responderá automáticamente a los mensajes Probe y Resolve.

Sintaxis

HRESULT Start(
  [in]           ULONGLONG            ullInstanceId,
  [in]           const WSD_URI_LIST   *pScopeList,
  [in, optional] IWSDDeviceHostNotify *pNotificationSink
);

Parámetros

[in] ullInstanceId

Identificador de la instancia. Si no se proporciona ningún identificador, el valor de instancia actual + 1 se usa como valor predeterminado.

Nota Para la compatibilidad con la especificación WS-Discovery, este valor debe ser menor o igual que UINT_MAX (4294967295).

 

[in] pScopeList

Ámbito del host del dispositivo. Si es NULL, no hay ningún ámbito asociado al host.

[in, optional] pNotificationSink

Referencia a un objeto IWSDDeviceHostNotify que especifica el receptor de notificaciones.

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes:

Código devuelto	Descripción
S_OK	El método se completó correctamente.
S_FALSE	El host del dispositivo ya se ha iniciado.
E_FAIL	Error en el método. Es posible que se haya producido un error porque el host no se ha inicializado. Llame a Init para inicializar un host de dispositivo.
E_ABORT	No hay metadatos asociados al host.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wsdhost.h (incluya Wsdapi.h)
Archivo DLL	Wsdapi.dll

Consulte también

IWSDDeviceHost