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 pesquisar dados de depuração. Vários caminhos devem ser delimitados por ponto-e-vírgula. Os caminhos podem conter um \.
cbCvInfo
[em] O tamanho em bytes do pbCvInfo parâmetro.
pbCvInfo
[em] As informações alternativas de exibição de código do cabeçalho de depuração (para substituir o que é normal lido do IMAGE_DEBUG_DIRECTORY do executável). Somente cabeçalhos RSDS ou NB10 são suportados.
pCallback
[em] Uma IUnknown interface para um objeto que dá suporte a uma interface de retorno de chamada de depuração, como as IDiaLoadCallbackIDiaLoadCallback2interfaces , , , IDiaReadExeAtOffsetCallbacke/ou 'IDiaReadExeAtRVACallback.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará 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 acessar um arquivo 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. |
Comentários
As informações de exibição de código, no IMAGE_DEBUG_TYPE_CODEVIEW formato, nomeiam o local dos dados de depuração associado, bem como os campos de sinalização e idade a serem correspondidos.
Se você estiver carregando dados de depuração de um servidor de símbolos, symsrv.dll deverá estar presente no mesmo diretório em que o aplicativo ou msdia140.dll do usuário está instalado ou deverá estar presente no diretório do sistema.
Esse método lê o cabeçalho de depuração fornecido e, em seguida, pesquisa e prepara os dados de depuração. O progresso da pesquisa pode, opcionalmente, ser relatado e controlado por meio 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 and 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
}