IWSDDeviceProxy::GetThisDeviceMetadata-Methode (wsdclient.h)
Ruft gerätespezifische Metadaten für dieses Gerät ab.
Syntax
HRESULT GetThisDeviceMetadata(
[out] WSD_THIS_DEVICE_METADATA **ppThisDeviceMetadata
);
Parameter
[out] ppThisDeviceMetadata
Verweis auf eine WSD_THIS_DEVICE_METADATA-Struktur , die die gerätespezifischen Metadaten dieses Geräts 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. |
|
ppThisDeviceMetadata ist NULL. |
Hinweise
GetThisDeviceMetadata bewirkt nicht, dass der Geräteproxy Metadaten vom Gerät abruft. Stattdessen gibt GetThisDeviceMetadata die Metadaten zurück, die mit dem letzten Aufruf von BeginGetMetadata und EndGetMetadata abgerufen wurden. Wenn keine dieser Methoden aufgerufen wurde, gibt GetThisDeviceMetadata 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 |