Compartilhar via

Método ICorDebugMetaDataLocator::GetMetaData

Solicita ao depurador que 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 [in] 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 [in] O carimbo de data/hora dos cabeçalhos de arquivo PE da imagem. Esse parâmetro pode potencialmente ser usado para uma pesquisa de servidor de símbolos (SymSrv).

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

cchPathBuffer [in] A contagem de caracteres em wszPathBuffer.

pcchPathBuffer [out] A contagem de WCHARs gravados em wszPathBuffer.

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

wszPathBuffer [out] 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.

Valor de retorno

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

HRESULT Description
S_OK O método foi concluído com êxito. wszPathBuffer contém o caminho completo para o arquivo e é encerrado em nulo.
E_NOT_SUFFICIENT_BUFFER O tamanho atual não wszPathBuffer é suficiente para manter o caminho completo. Nesse caso, pcchPathBuffer contém a contagem necessária de WCHARs, incluindo o caractere nulo de encerramento 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 despejo, ele especifica o caminho do computador em que o despejo foi coletado. O arquivo pode não existir nesse local ou um arquivo incorreto com o mesmo nome pode ser armazenado no caminho.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

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

Consulte também

  • Last updated on