IWSDDeviceProxy::Init-Methode (wsdclient.h)

Initialisiert den Geräteproxy und gibt optional eine Sitzung mit einem zuvor initialisierten Sponsoring-Geräteproxy frei.

Syntax

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

Parameter

[in] pszDeviceId

Die logische Adresse (ID) des Geräts.

[in] pDeviceAddress

Verweis auf ein IWSDAddress-Objekt , das die Gerätekonfigurationsdaten enthält.

[in] pszLocalId

Die logische Adresse des Clients. Die logische Adresse hat das Format urn:uuid:{guid}. Wird verwendet, wenn der Server eine Verbindung mit dem Client initiieren muss.

[in, optional] pContext

Verweis auf ein IWSDXMLContext-Objekt , das benutzerdefinierte Nachrichtentypen oder Namespaces definiert.

Bei NULL wird ein Standardkontext verwendet, der die integrierten Nachrichtentypen und Namespaces darstellt.

[in, optional] pSponsor

Verweis auf ein IWSDDeviceProxy-Objekt , bei dem es sich um ein optionales Gerät handelt, mit dem eine Sitzung und niedrigere Ebenen gemeinsam verwendet werden können.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG
pszDeviceId ist NULL, pszLocalId ist NULL, oder die Länge in Zeichen einer bezeichnerischen Zeichenfolge überschreitet WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

Diese Methode wird von WSDCreateDeviceProxy aufgerufen und muss normalerweise nicht direkt vom Clientcode aufgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wsdclient.h (include Wsdapi.h)
DLL Wsdapi.dll

Weitere Informationen

IWSDDeviceProxy