Compartilhar via

Interface IWSDDeviceHost (wsdhost.h)

  • Artigo

Representa um dispositivo compatível com DPWS. O host do dispositivo anunciará sua presença na rede usando o protocolo WS-Discovery. O host do dispositivo também responderá automaticamente a consultas de descoberta e solicitações de metadados.

O chamador pode registrar serviços implementados pelo usuário com o host do dispositivo. Esses serviços serão expostos nos metadados do dispositivo e os serviços estarão disponíveis pela rede. As mensagens associadas a esses serviços serão enviadas automaticamente para o objeto de serviço.

Chame WSDCreateDeviceHost ou WSDCreateDeviceHostAdvanced para criar um objeto que expõe essa interface.

Herança

A interface IWSDDeviceHost herda da interface IUnknown . IWSDDeviceHost também tem estes tipos de membros:

Métodos

A interface IWSDDeviceHost tem esses métodos.

 
IWSDDeviceHost::AddDynamicService

Registra um objeto de serviço para solicitações de entrada, mas não adiciona o serviço aos metadados do host do dispositivo. Isso é usado para serviços transitórios (dinâmicos).
IWSDDeviceHost::Init

Inicializa uma instância de um objeto IWSDDeviceHost.
IWSDDeviceHost::RegisterPortType

Registra um tipo de porta para mensagens de entrada.
IWSDDeviceHost::RegisterService

Registra um objeto de serviço para solicitações de entrada e adiciona o serviço aos metadados do host do dispositivo.
IWSDDeviceHost::RemoveDynamicService

Cancela o registro de um objeto de serviço que foi registrado usando AddDynamicService.
IWSDDeviceHost::RetireService

Cancela o registro de um objeto de serviço que foi registrado usando RegisterService e remove o serviço dos metadados do host do dispositivo.
IWSDDeviceHost::SetMetadata

Define os metadados de um dispositivo, excluindo metadados de serviço definidos pelo usuário.
IWSDDeviceHost::SetServiceDiscoverable

Controla se o serviço é anunciado ou não usando o WS-Discovery.
IWSDDeviceHost::SignalEvent

Notifica todos os clientes inscritos de que ocorreu um evento.
IWSDDeviceHost::Start

Inicia o host do dispositivo e publica o host do dispositivo usando uma mensagem do WS-Discovery Hello.
IWSDDeviceHost::Stop

Envia uma mensagem WS-Discovery Bye e interrompe o host.
IWSDDeviceHost::Terminate

Encerra o host e libera todos os serviços anexados.

Comentários

Depois de recuperar essa interface, o aplicativo:

  1. Chame o método RegisterPortType para registrar todos os tipos de porta necessários.
  2. Chame SetMetadata para descrever o dispositivo e, opcionalmente, chame RegisterService uma ou mais vezes para registrar os serviços descritos nos metadados do host do serviço.
  3. Chame o método Start para iniciar o host do dispositivo e publicar o dispositivo usando o WS-Discovery.Depois de iniciar o host do dispositivo, você pode opcionalmente:
    1. Chame AddDynamicService para serviços não descritos nos metadados do host de serviço (por exemplo, um trabalho de impressão ad hoc).
    2. Chame RetireService para encerrar a ação em e desconectar um serviço ativado pelo método RegisterService .
    3. Chame o método SignalEvent para indicar que as notificações devem ser enviadas para assinaturas relacionadas a um evento específico.
  4. Chame o método Stop para encerrar a execução do host e encerrar a publicação do dispositivo.

Um objeto IWSDDeviceHost pode fornecer um objeto para um serviço sob demanda (usando um retorno de chamada de notificação) ao chamar o host recebe uma mensagem de solicitação direcionada a esse serviço.

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)

Confira também

Visão geral das interfaces WSDAPI