IWICMetadataQueryReader::GetLocation-Methode (wincodec.h)

Ruft den aktuellen Pfad relativ zum Stammmetadatenblock ab.

Syntax

HRESULT GetLocation(
  [in]      UINT  cchMaxLength,
  [in, out] WCHAR *wzNamespace,
  [out]     UINT  *pcchActualLength
);

Parameter

[in] cchMaxLength

Typ: UINT

Die Länge des wzNamespace-Puffers .

[in, out] wzNamespace

Typ: WCHAR*

Zeiger, der den aktuellen Namespacespeicherort empfängt.

[out] pcchActualLength

Typ: UINT*

Die tatsächliche Pufferlänge, die zum Abrufen des aktuellen Namespacespeicherorts erforderlich war.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn Sie NULL an wzNamespace übergeben, ignoriert GetLocationcchMaxLength und gibt die erforderliche Pufferlänge zurück, um den Pfad in der Variablen zu speichern, auf die pcchActualLength zeigt.

Wenn der Abfrageleser relativ zum Anfang der Metadatenhierarchie steht, wird eine Zeichenfolge mit nur einem Zeichen zurückgegeben.

Wenn der Abfrageleser relativ zu einem geschachtelten Metadatenblock ist, gibt diese Methode den Pfad zum aktuellen Abfrageleser zurück.

Anforderungen

Siehe auch

Konzept

IWICMetadataQueryReader

Übersicht über das Lesen und Schreiben von Bildmetadaten

Übersicht über WIC-Metadaten