IWICMetadataQueryReader::GetMetadataByName-Methode (wincodec.h)

Artikel
03/06/2024

Ruft den Durch einen Metadatenabfrageausdruck identifizierten Metadatenblock oder -element ab.

Syntax

HRESULT GetMetadataByName(
  [in]      LPCWSTR     wzName,
  [in, out] PROPVARIANT *pvarValue
);

Parameter

[in] wzName

Typ: LPCWSTR

Der Abfrageausdruck für den angeforderten Metadatenblock oder -element.

[in, out] pvarValue

Typ: PROPVARIANT*

Wenn diese Methode zurückgibt, enthält den angeforderten Metadatenblock oder das angeforderte Element.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

GetMetadataByName verwendet Metadatenabfrageausdrücke, um auf eingebettete Metadaten zuzugreifen. Weitere Informationen zur Metadatenabfragesprache finden Sie in der Übersicht über die Metadatenabfragesprache.

Wenn mehrere Blöcke oder Elemente vorhanden sind, die durch denselben Abfrageausdruck ausgedrückt werden, wird der erste Metadatenblock oder das erste gefundene Element zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincodec.h
Bibliothek	Windowscodecs.lib
DLL	Windowscodecs.dll