IWICMetadataQueryReader::GetLocation method

Retrieves the current path relative to the root metadata block.

Syntax

HRESULT GetLocation(
  UINT  cchMaxLength,
  WCHAR *wzNamespace,
  UINT  *pcchActualLength
);

Parameters

cchMaxLength

Type: UINT

The length of the wzNamespace buffer.

wzNamespace

Type: WCHAR*

Pointer that receives the current namespace location.

pcchActualLength

Type: UINT*

The actual buffer length that was needed to retrieve the current namespace location.

Return Value

Type: HRESULT

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

Remarks

If you pass NULL to wzNamespace, GetLocation ignores cchMaxLength and returns the required buffer length to store the path in the variable that pcchActualLength points to.

If the query reader is relative to the top of the metadata hierarchy, it will return a single-char string.

If the query reader is relative to a nested metadata block, this method will return the path to the current query reader.

Requirements

   
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

IWICMetadataQueryReader

Overview of Reading and Writing Image Metadata

WIC Metadata Overview