Método ISymUnmanagedWriter::GetDebugInfo

  • Artigo

Retorna as informações necessárias para que um compilador grave a entrada do diretório de depuração no cabeçalho do arquivo executável portátil (PE). O gravador de símbolo preenche todos os campos, exceto para TimeDateStamp e PointerToRawData. (O compilador é responsável por definir esses dois campos adequadamente).

Um compilador deve chamar esse método, emitir o blob de dados no arquivo PE, definir o campo PointerToRawData no IMAGE_DEBUG_DIRECTORY para apontar para os dados emitidos e gravar o IMAGE_DEBUG_DIRECTORY no arquivo PE. O compilador também deve definir o campo TimeDateStamp como igual ao TimeDateStamp do arquivo PE que está sendo gerado.

Sintaxe

HRESULT GetDebugInfo(  
    [in, out] IMAGE_DEBUG_DIRECTORY *pIDD,  
    [in]  DWORD cData,  
    [out] DWORD *pcData,  
    [out, size_is(cData),  
        length_is(*pcData)] BYTE data[]);

Parâmetros

pIDD
[in, out] Um ponteiro para um IMAGE_DEBUG_DIRECTORY que o gravador de símbolos preencherá.

cData
[in] Um DWORD que contenha o tamanho dos dados de depuração.

pcData
[out] Um ponteiro para um DWORD que recebe o tamanho do buffer necessário para conter os dados de depuração.

data
[out] Um ponteiro para um buffer grande o suficiente para manter os dados de depuração para o repositório de símbolos.

Valor Retornado

S_OK se o método for bem-sucedido, caso contrário, E_FAIL ou algum outro código de erro.

Requisitos

Cabeçalho: CorSym.idl, CorSym.h

Confira também