IDiaDataSource::openSession
Abre uma sessão para consultar símbolos.
Sintaxe
HRESULT openSession (
IDiaSession** ppSession
);
Parâmetros
ppSession
[out] Retorna um objeto IDiaSession que representa a sessão aberta.
Valor Retornado
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_UNEXPECTED | O objeto IDiaDataSource não foi inicializado anteriormente com uma fonte de símbolos. |
| E_INVALIDARG | Parâmetro ppSession inválido. |
| E_OUTOFMEMORY | Memória insuficiente para abrir a sessão. |
Comentários
Esse método abre um objeto IDiaSession para uma fonte de dados.
Os objetos IDiaSession implementam consultas na fonte de dados. Uma sessão gerencia um espaço de endereço para cada conjunto de símbolos de depuração. Se o arquivo .exe ou .dll descrito pelos símbolos da fonte de dados estiver ativo em vários intervalos de endereços (por exemplo, porque vários processos o tiverem carregado), uma sessão para cada intervalo de endereços deverá ser usada.
Exemplo
IDiaSession* pSession;
HRESULT hr = pSource->openSession( &pSession );
if (FAILED(hr))
{
// report error
}