Método ICorDebugMetaDataLocator::GetMetaData

Artigo
11/05/2024

Solicita que o depurador retorne 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 (nomedearquivo.extensão).

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

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

cchPathBuffer [em] A contagem de caracteres em wszPathBuffer.

pcchPathBuffer [fora] A contagem de s gravada WCHARem wszPathBuffer.

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

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

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

Valor Retornado

Esse método retorna os HRESULTs específicos a seguir, bem como erros HRESULT que indicam a falha do método. Todas as outras falhas HRESULTs indicam que o arquivo não é recuperável.

HRESULT	Descrição
S_OK	O método foi concluído com sucesso. `wszPathBuffer` contém o caminho completo para o arquivo e é terminado em nulo.
E_NOT_SUFFICIENT_BUFFER	O tamanho atual de `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.

Comentários

Se wszImagePath contiver um caminho completo para um módulo de um despejo, ele especificará o caminho do computador em que o despejo foi coletado. O arquivo pode não existir neste local ou um arquivo incorreto com o mesmo nome pode estar armazenado no caminho.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: disponíveis desde 4

Compartilhar via