Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Prepara os dados de depuração armazenados em um arquivo de banco de dados do programa (.pdb) acessado por meio de um fluxo de dados potencialmente na memória, com pré-busca de registro opcional.
Sintaxe
HRESULT loadDataFromIStreamEx (
IStream* pIStream,
BOOL fPdbPrefetching
);
Parâmetros
pIStream
[in] Um IStream objeto que representa o fluxo de dados a ser usado.
fPdbPrefetching
[in] Se definido como TRUE, os registros de depuração adjacentes são pré-buscados na memória, potencialmente substituindo muitas operações menores de E/S de arquivo por menos operações maiores e, portanto, melhorando a taxa de transferência geral à medida que esses registros são acessados posteriormente, em detrimento do potencial aumento do uso da memória. Se definido como FALSE, isso se comporta de forma idêntica a IDiaDataSource::loadDataFromIStream. Se definido como algum outro valor, o comportamento não será especificado.
Valor de retorno
Se tiver êxito, retornará S_OK; caso contrário, retorna um código de erro. A tabela a seguir mostra os possíveis valores retornados para este método.
| Valor | Descrição |
|---|---|
E_PDB_FORMAT |
Tentativa de acessar um arquivo com um formato obsoleto. |
E_INVALIDARG |
Parâmetro inválido. |
E_UNEXPECTED |
A fonte de dados já foi preparada. |
Observações
Esse método permite que os dados de depuração de um executável sejam obtidos da memória por meio de um IStream objeto.
Para carregar um arquivo .pdb sem validação, use o IDiaDataSourceEx::loadDataFromPdbEx método.
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.