WSDCreateDeviceHost-Funktion (wsdhost.h)

Erstellt einen Gerätehost und gibt einen Zeiger auf die IWSDDeviceHost-Schnittstelle zurück.

Syntax

HRESULT WSDCreateDeviceHost(
  [in]  LPCWSTR        pszLocalId,
  [in]  IWSDXMLContext *pContext,
  [out] IWSDDeviceHost **ppDeviceHost
);

Parameter

[in] pszLocalId

Die logische oder physische Adresse des Geräts. Eine logische Adresse hat das Format urn:uuid:{guid}. Wenn pszLocalId eine logische Adresse ist, gibt der Host die logische Adresse an und konvertiert die Adresse dann in eine physische Adresse, wenn er Resolve- oder Testnachrichten empfängt.

Wenn pszLocalId eine physische Adresse ist (z. B. url mit dem Präfix http oder https), verwendet der Host die Adresse als physische Adresse und hostet diese Adresse anstelle der Standardadresse.

Für eine sichere Kommunikation muss pszLocalId eine URL mit dem Präfix https sein, und der Host verwendet das SSL/TLS-Protokoll an dem port, der in der URL angegeben ist. Der empfohlene Port ist Port 5358, da dieser Port für sichere Verbindungen mit WSDAPI reserviert ist. Wenn kein Port angegeben ist, verwendet der Host Port 443. Der Hostport muss mit einem SSL-Serverzertifikat konfiguriert werden, bevor WSDCreateDeviceHost aufgerufen wird. Weitere Informationen zur Konfiguration von Hostports finden Sie unter HttpSetServiceConfiguration.

Jede URL (http oder https) muss mit einem nachgestellten Schrägstrich beendet werden. Die URL muss eine gültige IP-Adresse oder einen gültigen Hostnamen enthalten.

Die folgende Liste enthält einige Beispielwerte für pszLocalId. Es handelt sich nicht um eine vollständige Liste gültiger Werte.

• http://192.168.0.1:5357/
• http://localhost/
• http://myHostname:5357/
• https://192.168.0.1:5358/
• https://myHostname/
• https://myHostname/myDevice/
• https://myHostname:5358/

[in] pContext

Ein IWSDXMLContext-Objekt , das benutzerdefinierte Nachrichtentypen oder Namespaces definiert.

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

[out] ppDeviceHost

Zeiger auf ein IWSDDeviceHost-Objekt , das Sie verwenden, um die WSD-spezifische Gerätesemantik verfügbar zu machen, die einem Server zugeordnet ist, der auf eingehende Anforderungen antwortet.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem:

Hinweise

Die WSDCreateDeviceHost-Funktion ruft die IWSDDeviceHost::Init-Methode auf, die eine instance eines IWSDDeviceHost-Objekts initialisiert.

Anforderungen

Weitere Informationen

WSDCreateDeviceHostAdvanced