Partilhar via

IDiaDataSource::loadDataFromCodeViewInfo

Abre e prepara os dados de depuração associados ao .exe/.dll arquivo.

Sintaxe

HRESULT loadDataFromCodeViewInfo (
   LPCOLESTR executable,
   LPCOLESTR searchPath,
   DWORD     cbCvInfo,
   BYTE*     pbCvInfo,
   IUnknown* pCallback
);

Parâmetros

executável

[em] Caminho para o .exe arquivo ou .dll .

searchPath

[em] Caminhos alternativos para procurar dados de depuração. Vários caminhos devem ser delimitados por ponto-e-vírgula. Os caminhos podem conter um trailing \.

cbCvInfo

[em] O tamanho em bytes do pbCvInfo parâmetro.

pbCvInfo

[em] As informações de visualização de código de cabeçalho de depuração alternativo (para substituir o que é normal lido do IMAGE_DEBUG_DIRECTORY do executável). Apenas cabeçalhos RSDS ou NB10 são suportados.

pRetorno de chamada

[em] Uma IUnknown interface para um objeto que suporta uma interface de retorno de chamada de depuração, como as IDiaLoadCallbackinterfaces , IDiaLoadCallback2, , IDiaReadExeAtOffsetCallbacke/ou 'IDiaReadExeAtRVACallback .

Valor de retorno

Se for bem-sucedido, retorna S_OK; caso contrário, retorna um código de erro. A tabela a seguir mostra alguns dos códigos de erro possíveis para esse método.

Valor Descrição
E_PDB_NOT_FOUND Falha ao abrir o arquivo ou o arquivo tem um formato inválido.
E_PDB_FORMAT Tentativa de aceder a um ficheiro com um formato não suportado.
E_PDB_INVALID_SIG A assinatura não corresponde.
E_PDB_INVALID_AGE A idade não corresponde.
E_INVALIDARG Parâmetro inválido.
E_UNEXPECTED A fonte de dados já foi preparada.

Observações

As informações de visualização de código, em IMAGE_DEBUG_TYPE_CODEVIEW formato, nomeiam o local dos dados de depuração associados, bem como fornecem os campos de sinalização e idade para corresponder.

Se você estiver carregando dados de depuração de um servidor de símbolos, symsrv.dll deve estar presente no mesmo diretório onde o aplicativo ou msdia140.dll do usuário está instalado, ou deve estar presente no diretório do sistema.

Esse método lê o cabeçalho de depuração fornecido e, em seguida, procura e prepara os dados de depuração. O progresso da pesquisa pode, opcionalmente, ser reportado e controlado através de retornos de chamada. Por exemplo, o IDiaLoadCallback::NotifyDebugDir é invocado quando o método localiza e processa IDiaDataSource::loadDataForExe um diretório de depuração.

As IDiaReadExeAtOffsetCallback interfaces e IDiaReadExeAtRVACallback permitem que o aplicativo cliente forneça métodos alternativos para ler dados do arquivo executável quando o arquivo não pode ser acessado diretamente por meio de E/S de arquivo padrão.

Para carregar um .pdb arquivo sem validação, use o IDiaDataSource::loadDataFromPdb método.

Para validar o arquivo .pdb em relação a critérios específicos, use o IDiaDataSource::loadAndValidateDataFromPdb método.

Para carregar um arquivo .pdb diretamente da memória, use o IDiaDataSource::loadDataFromIStream método.

Para validar um arquivo .pdb sem carregá-lo, use o método IDiaDataSourceEx::ValidatePdb' .

Exemplo

BYTE pbCodeViewInfo[] = {
  ...
};

HRESULT hr = pSource->loadDataFromCodeViewInfo( L"myprog.exe", L".\debug", sizeof(pbCodeViewInfo), pbCodeViewInfo, nullptr);
if (FAILED(hr))
{
    // Report error
}

Ver também

  • Last updated on