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:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
pszLocalId ist NULL oder die Länge in Den Zeichen von pszLocalId überschreitet WSD_MAX_TEXT_LENGTH (8192). |
|
ppDeviceHost ist NULL. |
|
Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen. |
Hinweise
Die WSDCreateDeviceHost-Funktion ruft die IWSDDeviceHost::Init-Methode auf, die eine instance eines IWSDDeviceHost-Objekts initialisiert.
Anforderungen
| 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) |
| Bibliothek | Wsdapi.lib |
| DLL | Wsdapi.dll |