Compartilhar via

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

  • Artigo

Inicializa uma instância de um objeto IWSDDeviceHost , que é a representação do lado do host de um dispositivo.

Sintaxe

HRESULT Init(
  [in]           LPCWSTR        pszLocalId,
  [in, optional] IWSDXMLContext *pContext,
  [in, optional] IWSDAddress    **ppHostAddresses,
  [in, optional] DWORD          dwHostAddressCount
);

Parâmetros

[in] pszLocalId

O endereço lógico ou físico do dispositivo. Um endereço lógico é do formato urn:uuid:{guid}. Se pszLocalId for um endereço lógico, o host anunciará o endereço lógico e converterá o endereço em um endereço físico quando receber mensagens resolver ou investigar.

Se pszLocalId for um endereço físico (como URL prefixada por http ou https), o host usará o endereço como o endereço físico e será hospedado nesse endereço em vez do padrão.

Para comunicação segura, pszLocalId deve ser uma URL prefixada por https e o host usará o protocolo SSL/TLS na porta especificada na URL. A porta recomendada é a porta 5358, pois essa porta é reservada para conexões seguras com o WSDAPI. Se nenhuma porta for especificada, o host usará a porta 443. A porta do host deve ser configurada com um certificado de servidor SSL. Para obter mais informações sobre a configuração de portas de host, consulte HttpSetServiceConfiguration.

Qualquer URL (http ou https) deve ser encerrada com uma barra à direita. A URL deve conter um endereço IP ou nome do host válido.

A lista a seguir mostra alguns valores de exemplo para pszLocalId. Não é uma lista completa de valores válidos.

  • http://192.168.0.1:5357/
  • http://localhost/
  • http://myHostname:5357/
  • https://192.168.0.1:5358/
  • https://myHostname/
  • https://myHostname/myDevice/
  • https://myHostname:5358/

[in, optional] pContext

Uma interface IWSDXMLContext que define tipos de mensagem ou namespaces personalizados.

[in, optional] ppHostAddresses

Um único objeto IWSDAddress ou objeto IWSDTransportAddress . Os objetos fornecem informações sobre endereços específicos nos quais o host deve escutar.

Se pszLocalId contiver um endereço local, o comportamento resultante será um mapeamento entre o endereço lógico e o endereço físico fornecido (em vez de um mapeamento entre o endereço lógico e o endereço físico padrão).

[in, optional] dwHostAddressCount

O número de itens na matriz ppHostAddresses . Se ppHostAddresses for uma interface IWSDAddress , count deverá ser 1.

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_INVALIDARG
 pszLocalId é NULL, o comprimento em caracteres de pszLocalId excede WSD_MAX_TEXT_LENGTH (8192) ou o número de endereços referenciados por ppHostAddresses não corresponde a dwHostAddressCount.
E_FAIL
 O host do dispositivo está em um estado inesperado.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.
E_ABORT
 Não foi possível concluir a inicialização.

Comentários

Esse método é chamado por WSDCreateDeviceHost e normalmente não precisa ser chamado diretamente pelo código.

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