IWMDMStorage4::GetSpecifiedMetadata-Methode (mswmdm.h)

Artikel
03/06/2024

Die GetSpecifiedMetadata-Methode ruft eine oder mehrere spezifische Metadateneigenschaften aus dem Speicher ab.

Syntax

HRESULT GetSpecifiedMetadata(
  [in]  DWORD         cProperties,
  [in]  LPCWSTR       *ppwszPropNames,
  [out] IWMDMMetaData **ppMetadata
);

Parameter

[in] cProperties

Anzahl der abzurufenden Eigenschaften.

[in] ppwszPropNames

Array der abzurufenden Eigenschaftennamen. Die Länge dieses Arrays sollte gleich cProperties sein. Die Anwendung sollte diesen Arbeitsspeicher mithilfe von CoTaskMemFree freigeben.

[out] ppMetadata

Zeiger auf den zurückgegebenen IWMDMMetaData-Schnittstellenzeiger , der die abgerufenen Werte enthält. Der Aufrufer muss diese Schnittstelle freigeben, wenn er damit fertig ist.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode gibt dem Client die Kontrolle darüber, welche Eigenschaften abgerufen werden. Dies kann effizienter als IWMDMStorage3::GetMetadata sein und wird empfohlen, wenn der Client nur eine Teilmenge der vom Speicher unterstützten Eigenschaften benötigt.

Wenn diese Methode zum Abrufen von Daten von einem WPD-Gerät (Windows Portable Devices) verwendet wird, werden die Daten in binärer Form in einem IPortableDeviceValues-Objekt zurückgegeben. Die Anwendung sollte diese Daten de serialisieren, um die tatsächlichen Eigenschaftswerte abzurufen.

Die Methode ist erfolgreich und gibt WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED zurück, auch wenn einige der angegebenen Eigenschaften nicht abgerufen werden konnten (aber mindestens eine Eigenschaft abgerufen wurde). Die Methode schlägt fehl und gibt WMDM_E_NOTSUPPORTED zurück, wenn keine der angegebenen Eigenschaften abgerufen werden konnte.

Das Anfordern einer einzelnen Eigenschaft ist ein Sonderfall dieser Methode. Wenn der Client eine einzelne Eigenschaft anfordert, werden die möglichen Rückgabecodes S_OK, E_INVALIDARG und WMDM_E_NOTSUPPORTED. Im Fall einer einzelnen Eigenschaft ist die Methode daher nur erfolgreich, wenn die Eigenschaft erfolgreich abgerufen wurde.