Método de ICorDebugMetaDataLocator::GetMetaData

Artigo
08/08/2011

Solicita que o depurador para retornar o caminho completo para um módulo cujo metadados é necessário para concluir uma operação solicitado do depurador.

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 seqüência terminada por caractere nulo que representa o caminho completo para o arquivo. Se o caminho completo não estiver disponível, o nome e extensão do arquivo (nome de arquivo.extensão).
dwImageTimeStamp
[in] O carimbo de hora de cabeçalhos de arquivo PE da imagem. Esse parâmetro potencialmente pode ser usado para um servidor de símbolos (SymSrv) pesquisa.
dwImageSize
[in] O tamanho da imagem dos cabeçalhos do arquivo PE. Esse parâmetro potencialmente pode ser usado para uma pesquisa SymSrv.
cchPathBuffer
[in] O caractere contar em wszPathBuffer.
pcchPathBuffer
[out] A contagem de WCHARs gravado em wszPathBuffer.

Se o método retorna E_NOT_SUFFICIENT_BUFFER, contém a contagem de WCHARs necessários para armazenar o caminho.
wszPathBuffer
[out] Ponteiro para um buffer no qual o depurador irá copiar o caminho completo do arquivo que contém os metadados solicitados.

O ofReadOnly Sinalizador da CorOpenFlags enumeração é usada para solicitar acesso somente leitura para os metadados nesse arquivo.

Valor de retorno

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

HRESULT	Descrição
S_OK	O método foi concluído com êxito. wszPathBuffercontém o caminho completo para o arquivo e terminada por caractere nulo.
E_NOT_SUFFICIENT_BUFFER	O tamanho atual do wszPathBuffer não é suficiente conter o caminho completo Nesse caso, pcchPathBuffer contém a quantidade necessária de WCHARs, incluindo o caractere nulo de terminação, e GetMetaData é chamado pela segunda vez com o tamanho do buffer solicitado.

Comentários

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