Método IWICMetadataQueryReader::GetLocation (wincodec.h)

Recupera o caminho atual em relação ao bloco de metadados raiz.

Sintaxe

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

Parâmetros

[in] cchMaxLength

Tipo: UINT

O comprimento do buffer wzNamespace .

[in, out] wzNamespace

Tipo: WCHAR*

Ponteiro que recebe o local atual do namespace.

[out] pcchActualLength

Tipo: UINT*

O comprimento real do buffer necessário para recuperar o local do namespace atual.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se você passar NULL para wzNamespace, GetLocation ignorará cchMaxLength e retornará o comprimento do buffer necessário para armazenar o caminho na variável para a qual pcchActualLength aponta.

Se o leitor de consulta for relativo à parte superior da hierarquia de metadados, ele retornará uma cadeia de caracteres de caractere único.

Se o leitor de consulta for relativo a um bloco de metadados aninhados, esse método retornará o caminho para o leitor de consulta atual.

Requisitos

Confira também

Conceitual

IWICMetadataQueryReader

Visão geral dos metadados de imagem de leitura e gravação

Visão geral dos metadados do WIC