Compartilhar via

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

  • Artigo

Notifica todos os clientes inscritos de que ocorreu um evento.

Sintaxe

HRESULT SignalEvent(
  [in] LPCWSTR             pszServiceId,
  [in] const void          *pBody,
  [in] const WSD_OPERATION *pOperation
);

Parâmetros

[in] pszServiceId

A ID do serviço que gera o evento.

[in] pBody

O corpo do evento.

[in] pOperation

Referência a uma estrutura WSD_OPERATION que especifica a operaçã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.
E_FAIL
 O host não foi iniciado. Chame Iniciar para iniciar o host do dispositivo.
E_INVALIDARG
 pszServiceId é NULL, pOperation é NULL, o comprimento em caracteres de pszServiceId excede WSD_MAX_TEXT_LENGTH (8192), não há nenhuma estrutura ResponseType associada a pOperation ou o serviço especificado por pszServiceId não está inscrito no evento especificado pelo membro ResponseType de pOperation.

Comentários

SignalEvent bloqueia até que o evento seja enviado a todos os clientes. Como os clientes são contatados sequencialmente, é possível que SignalEvent seja bloqueado por um longo tempo se algum cliente responder lentamente ou estiver inacessível.

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