IDiaDataSourceEx::loadDataFromPdbEx
Abre e prepara um arquivo de banco de dados de programa (.pdb) como uma fonte de dados de depuração com pré-busca de registro opcional.
Sintaxe
HRESULT loadDataFromPdbEx (
LPCOLESTR pdbPath,
BOOL fPdbPrefetching
);
Parâmetros
pdbPath
[in] O caminho para o arquivo .pdb.
fPdbPrefetching
[em] Se definido como TRUE, os registros de depuração adjacentes são pré-buscados na memória, potencialmente substituindo muitas operações de E/S de arquivo menores por menos operações maiores e, assim, melhorando a taxa de transferência geral à medida que esses registros são acessados posteriormente, às custas de um uso de memória potencialmente aumentado. Se definido como FALSE, isso se comporta de forma idêntica a IDiaDataSource::loadDataFromPdb. Se definido como algum outro valor, o comportamento não será especificado.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro. A tabela a seguir mostra os possíveis valores retornados para esse método.
| Valor | Descrição |
|---|---|
E_PDB_NOT_FOUND |
Falha ao abrir o arquivo, ou determinado que o arquivo tem um formato inválido. |
E_PDB_FORMAT |
Tentativa de acessar um arquivo com um formato incompatível ou não suportado. |
E_INVALIDARG |
Parâmetro inválido. |
E_UNEXPECTED |
A fonte de dados já foi preparada. |
Comentários
Esse método carrega os dados de depuração diretamente de um arquivo .pdb.
Para validar o arquivo .pdb em relação a critérios específicos, use o IDiaDataSourceEx::loadAndValidateDataFromPdbEx método.
Para obter acesso ao processo de carregamento de dados (por meio de um mecanismo de retorno de chamada), use o IDiaDataSourceEx::loadDataForExeEx método.
Para carregar um arquivo .pdb diretamente da memória, use o IDiaDataSourceEx::loadDataFromIStreamEx método.
Para validar um arquivo .pdb sem carregá-lo, use o IDiaDataSourceEx::ValidatePdb método.
Exemplo
HRESULT hr = pSource->loadDataFromPdbEx( L"myprog.pdb", TRUE );
if (FAILED(hr))
{
// report error
}