IMDSPStorage4::GetSpecifiedMetadata-Methode (mswmdm.h)

Artikel
03/04/2024

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

Freigeben über