IWSDDeviceProxy::GetHostMetadata-Methode (wsdclient.h)
Ruft klassenspezifische Metadaten für das Gerät ab, die die Features des Geräts und die dienste beschreiben, die es hostet.
Syntax
HRESULT GetHostMetadata(
[out] WSD_HOST_METADATA **ppHostMetadata
);
Parameter
[out] ppHostMetadata
Verweis auf eine WSD_HOST_METADATA-Struktur , die Metadaten angibt. Lassen Sie dieses Objekt nicht frei.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Mögliche Rückgabewerte sind u. a. die folgenden:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
ppHostMetadata ist NULL. |
Hinweise
GetHostMetadata bewirkt nicht, dass der Geräteproxy Metadaten vom Gerät abruft. Stattdessen gibt GetHostMetadata die Metadaten zurück, die mit dem letzten Aufruf von BeginGetMetadata und EndGetMetadata abgerufen wurden. Wenn keine dieser Methoden aufgerufen wurde, gibt GetHostMetadata die Metadaten zurück, die beim Initialisieren des IWSDDeviceProxy-Objekts abgerufen wurden.
Bei erfolgreicher Ausführung ist der Arbeitsspeicher bei ppMetadata gültig, bis BeginGetMetadata oder EndGetMetadata aufgerufen wird oder bis das IWSDDeviceProxy-Objekt freigegeben wird.
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 |