IWSDDeviceProxy::Init-Methode (wsdclient.h)

Artikel
03/09/2024

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

Freigeben über