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

Artigo
03/04/2024

Inicia o host do dispositivo e publica o host do dispositivo usando uma mensagem do WS-Discovery Hello. Se um coletor de notificação for passado para esse método, o coletor de notificação também será registrado. Depois que Start for chamado com êxito, o host do dispositivo responderá automaticamente às mensagens De investigação e resolução.

Sintaxe

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

Parâmetros

[in] ullInstanceId

O identificador da instância. Se nenhum identificador for fornecido, o valor da instância atual + 1 será usado como o padrão.

Nota Para compatibilidade com a especificação de WS-Discovery, esse valor deve ser menor ou igual a UINT_MAX (4294967295).

[in] pScopeList

Escopo do host do dispositivo. Se FOR NULL, nenhum escopo será associado ao host.

[in, optional] pNotificationSink

Referência a um objeto IWSDDeviceHostNotify que especifica o coletor de notificação.

Retornar valor

Os valores retornados possíveis incluem, mas não se limitam a:

Código de retorno	Descrição
S_OK	Método concluído com êxito.
S_FALSE	O host do dispositivo já foi iniciado.
E_FAIL	O método falhou. Pode ter falhado porque o host não foi inicializado. Chame Init para inicializar um host do dispositivo.
E_ABORT	Não há metadados associados ao host.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wsdhost.h (include Wsdapi.h)
DLL	Wsdapi.dll

Confira também

Iwsddevicehost

Compartilhar via