IMDSPStorage4::GetSpecifiedMetadata-Methode (mswmdm.h)

Die GetSpecifiedMetadata-Methode ruft nur das angegebene Metadatenobjekt für einen Speicher ab.

Syntax

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

Parameter

[in] cProperties

Anzahl der abzurufenden Eigenschaften.

[in] ppwszPropNames

Array, das die abzurufenden Eigenschaftennamen enthält. Die Größe dieses Arrays sollte gleich cProperties sein.

[out] pMetadata

Zeiger auf den zurückgegebenen IWMDMMetaData-Schnittstellenzeiger .

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. Der Client kann die Eigenschaftennamen für die Eigenschaften angeben, die der Client abrufen muss.

Im Gegensatz dazu ruft die GetMetadata-Methode alle Speichermetadaten (Eigenschaften) ab.

Wenn keine der angegebenen Eigenschaften zurückgegeben werden kann, sollte der Dienstanbieter WMDM_E_NOTSUPPORTED oder einen geeigneten Fehlercode zurückgeben.

Wenn mindestens eine Eigenschaft abgerufen werden kann, sollte der Dienstanbieter diese Eigenschaft zurückgeben und den Rückgabecode auf einen Erfolgscode von WMDM_S_NOT_ALL_PROPERTIES_RETRIEVED festlegen.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPStorage4-Schnittstelle