IWSDDeviceProxy::GetAllMetadata-Methode (wsdclient.h)
Ruft alle Metadaten für dieses Gerät ab.
Syntax
HRESULT GetAllMetadata(
[out] WSD_METADATA_SECTION_LIST **ppMetadata
);
Parameter
[out] ppMetadata
Verweis auf eine WSD_METADATA_SECTION_LIST Struktur, die alle Metadaten im Zusammenhang mit einem Gerät 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. |
|
ppMetadata ist NULL. |
Hinweise
Diese Methode wird bereitgestellt, damit auf erweiterte Metadaten zugegriffen werden kann. Hersteller, Diensthost und gerätespezifische Metadaten werden am besten mit Methoden abgerufen, die speziell für diese Zwecke bereitgestellt werden.
GetAllMetadata bewirkt nicht, dass der Geräteproxy Metadaten vom Gerät abruft. Stattdessen gibt GetAllMetadata die Metadaten zurück, die mit dem letzten Aufruf von BeginGetMetadata und EndGetMetadata abgerufen wurden. Wenn keine dieser Methoden aufgerufen wurde, gibt GetAllMetadata 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
| 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 |