IWICBitmapDecoder::GetMetadataQueryReader method (wincodec.h)

Retrieves the metadata query reader from the decoder.

Syntax

HRESULT GetMetadataQueryReader(
  [out] IWICMetadataQueryReader **ppIMetadataQueryReader
);

Parameters

[out] ppIMetadataQueryReader

Type: IWICMetadataQueryReader**

Receives a pointer to the decoder's IWICMetadataQueryReader.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If an image format does not support container-level metadata, this will return WINCODEC_ERR_UNSUPPORTEDOPERATION. The only Windows provided image format that supports container-level metadata is GIF. Instead, use IWICBitmapFrameDecode::GetMetadataQueryReader.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2, Windows Vista [desktop apps | UWP apps]
Minimum supported server	Windows Server 2008 [desktop apps | UWP apps]
Target Platform	Windows
Header	wincodec.h
Library	Windowscodecs.lib
DLL	Windowscodecs.dll

See also

Conceptual

IWICBitmapDecoder

Metadata Query Language Overview

Overview of Reading and Writing Image Metadata

WIC Metadata Overview