IWSDDeviceHost::Start-Methode (wsdhost.h)

  • Artikel

Startet den Gerätehost und veröffentlicht den Gerätehost mithilfe einer WS-Discovery Hello-Nachricht. Wenn eine Benachrichtigungssenke an diese Methode übergeben wird, wird auch die Benachrichtigungssenke registriert. Nachdem Start erfolgreich aufgerufen wurde, reagiert der Gerätehost automatisch auf Test- und Auflösungsmeldungen.

Syntax

HRESULT Start(
  [in]           ULONGLONG            ullInstanceId,
  [in]           const WSD_URI_LIST   *pScopeList,
  [in, optional] IWSDDeviceHostNotify *pNotificationSink
);

Parameter

[in] ullInstanceId

Der Instanzbezeichner. Wenn kein Bezeichner angegeben wird, wird der aktuelle instance Wert + 1 als Standardwert verwendet.

Hinweis Zur Kompatibilität mit der WS-Discovery-Spezifikation muss dieser Wert kleiner oder gleich UINT_MAX (4294967295) sein.
 

[in] pScopeList

Bereich des Gerätehosts. Bei NULL sind dem Host keine Bereiche zugeordnet.

[in, optional] pNotificationSink

Verweis auf ein IWSDDeviceHostNotify-Objekt , das die Benachrichtigungssenke angibt.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
S_FALSE
 Der Gerätehost wurde bereits gestartet.
E_FAIL
 Fehler bei der Methode. Möglicherweise ist ein Fehler aufgetreten, weil der Host nicht initialisiert wurde. Rufen Sie Init auf, um einen Gerätehost zu initialisieren.
E_ABORT
 Dem Host sind keine Metadaten zugeordnet.

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

Weitere Informationen

IWSDDeviceHost