Método ICorDebugMetaDataLocator::GetMetaData

Artigo
11/05/2024

Pede ao depurador para retornar o caminho completo para um módulo cujos metadados são necessários para concluir uma operação solicitada pelo depurador.

Sintaxe

HRESULT GetMetaData(
      [in] LPCWSTR wszImagePath,
      [in] DWORD   dwImageTimeStamp,
      [in] DWORD   dwImageSize,
      [in] ULONG32 cchPathBuffer,
      [out] ULONG32 * pcchPathBuffer,
      [out, size_is(cchPathBuffer), length_is(*pcchPathBuffer)]
               WCHAR wszPathBuffer[]
      );

Parâmetros

wszImagePath [em] Uma cadeia de caracteres terminada em nulo que representa o caminho completo para o arquivo. Se o caminho completo não estiver disponível, o nome e a extensão do arquivo (nome do arquivo.extensão).

dwImageTimeStamp [em] O carimbo de data/hora dos cabeçalhos do arquivo PE da imagem. Este parâmetro pode ser usado potencialmente para uma pesquisa de servidor de símbolos (SymSrv).

dwImageSize [em] O tamanho da imagem dos cabeçalhos dos arquivos PE. Este parâmetro pode ser usado para uma pesquisa SymSrv.

cchPathBuffer [em] Os caracteres contam em wszPathBuffer.

pcchPathBuffer [saídas] A contagem de WCHARs escrita em wszPathBuffer.

Se o método retornar E_NOT_SUFFICIENT_BUFFER, contém a contagem de WCHARs necessária para armazenar o caminho.

wszPathBuffer [saídas] Ponteiro para um buffer no qual o depurador copiará o caminho completo do arquivo que contém os metadados solicitados.

O ofReadOnly sinalizador da enumeração CorOpenFlags é usado para solicitar acesso somente leitura aos metadados neste arquivo.

Devolver Valor

Esse método retorna os seguintes HRESULTs específicos, bem como erros HRESULT que indicam falha do método. Todos os outros HRESULTs de falha indicam que o arquivo não é recuperável.

HRESULTADO	Description
S_OK	O método foi concluído com êxito. `wszPathBuffer` contém o caminho completo para o arquivo e é terminado em nulo.
E_NOT_SUFFICIENT_BUFFER	O tamanho atual do `wszPathBuffer` não é suficiente para manter o caminho completo. Nesse caso, `pcchPathBuffer` contém a contagem necessária de `WCHAR`s, incluindo o caractere nulo de terminação, e `GetMetaData` é chamado uma segunda vez com o tamanho do buffer solicitado.

Observações

Se wszImagePath contiver um caminho completo para um módulo de um dump, ele especifica o caminho do computador onde o dump foi coletado. O arquivo pode não existir neste local ou um arquivo incorreto com o mesmo nome pode ser armazenado no caminho.

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponível desde 4

Partilhar via