Metodo IWSDDeviceProxy::Init (wsdclient.h)

Articolo
03/04/2024

Inizializza il proxy del dispositivo, condividendo facoltativamente una sessione con un proxy del dispositivo sponsorizzato in precedenza.

Sintassi

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

Parametri

[in] pszDeviceId

Indirizzo logico (ID) del dispositivo.

[in] pDeviceAddress

Riferimento a un oggetto IWSDAddress che contiene i dati di configurazione del dispositivo.

[in] pszLocalId

Indirizzo logico del client. L'indirizzo logico è nel formato urn:uuid:{guid}. Utilizzato quando il server deve avviare una connessione al client.

[in, optional] pContext

Riferimento a un oggetto IWSDXMLContext che definisce tipi di messaggi o spazi dei nomi personalizzati.

Se NULL, viene utilizzato un contesto predefinito che rappresenta i tipi di messaggio e gli spazi dei nomi predefiniti.

[in, optional] pSponsor

Riferimento a un oggetto IWSDDeviceProxy che è un dispositivo facoltativo con cui condividere una sessione e livelli inferiori.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente.
E_INVALIDARG	pszDeviceId è NULL, pszLocalId è NULL o la lunghezza in caratteri di una stringa di identificatore supera WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.

Commenti

Questo metodo viene chiamato da WSDCreateDeviceProxy e normalmente non deve essere chiamato direttamente dal codice client.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsdclient.h (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDDeviceProxy

Condividi tramite