Compartilhar via

Método IWSDDeviceProxy::Init (wsdclient.h)

  • Artigo

Inicializa o proxy do dispositivo, opcionalmente compartilhando uma sessão com um proxy de dispositivo de patrocínio inicializado anteriormente.

Sintaxe

HRESULT Init(
  [in]           LPCWSTR         pszDeviceId,
  [in]           IWSDAddress     *pDeviceAddress,
  [in]           LPCWSTR         pszLocalId,
  [in, optional] IWSDXMLContext  *pContext,
  [in, optional] IWSDDeviceProxy *pSponsor
);

Parâmetros

[in] pszDeviceId

O endereço lógico (ID) do dispositivo.

[in] pDeviceAddress

Referência a um objeto IWSDAddress que contém os dados de configuração do dispositivo.

[in] pszLocalId

O endereço lógico do cliente. O endereço lógico é do formulário, urn:uuid:{guid}. Usado quando o servidor precisa iniciar uma conexão com o cliente.

[in, optional] pContext

Referência a um objeto IWSDXMLContext que define tipos de mensagem ou namespaces personalizados.

Se FOR NULL, um contexto padrão que representa os tipos de mensagens internos e namespaces será usado.

[in, optional] pSponsor

Referência a um objeto IWSDDeviceProxy que é um dispositivo opcional com o qual compartilhar uma sessão e camadas inferiores.

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
 pszDeviceId é NULL, pszLocalId é NULL ou o comprimento em caracteres de qualquer cadeia de caracteres de identificador excede WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.

Comentários

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

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 wsdclient.h (include Wsdapi.h)
DLL Wsdapi.dll

Confira também

Iwsddeviceproxy