IWICMetadataQueryWriter::RemoveMetadataByName-Methode (wincodec.h)

Entfernt ein Metadatenelement von einem bestimmten Speicherort mithilfe eines Metadatenabfrageausdrucks.

Syntax

HRESULT RemoveMetadataByName(
  [in] LPCWSTR wzName
);

Parameter

[in] wzName

Typ: LPCWSTR

Der Name des zu entfernenden Metadatenelements.

Rückgabewert

Typ: HRESULT

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

Hinweise

RemoveMetadataByName verwendet Metadatenabfrageausdrücke, um Metadaten zu entfernen. Weitere Informationen zur Sprache der Metadatenabfrage finden Sie unter Übersicht über die Metadatenabfragesprache.

Wenn das Metadatenelement ein Metadatenblock ist, wird es aus der Metadatenhierarchie entfernt.

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

Siehe auch

Konzept

Vorgehensweise: Erneutes Codieren eines JPEG-Bilds mit Metadaten

IWICMetadataQueryWriter

Übersicht über die Metadaten-Abfragesprache

Übersicht über das Lesen und Schreiben von Bildmetadaten

Übersicht über WIC-Metadaten