IDiaDataSource::openSessionIDiaDataSource::openSession

Se abre una sesión para consultar los símbolos.Opens a session for querying symbols.

SintaxisSyntax

HRESULT openSession (   
   IDiaSession** ppSession  
);  

ParámetrosParameters

ppSessionppSession
[out] Devuelve un IDiaSession objeto que representa la sesión abierta.[out] Returns an IDiaSession object representing the open session.

Valor devueltoReturn Value

Si se realiza correctamente, devuelve S_OK; en caso contrario, devuelve un código de error.If successful, returns S_OK; otherwise, returns an error code. La tabla siguiente muestran los posibles valores devueltos para este método.The following table shows the possible return values for this method.

ValorValue DescripciónDescription
E_UNEXPECTEDE_UNEXPECTED El IDiaDataSource objeto previamente no se ha inicializado con un origen de símbolos.The IDiaDataSource object has not previously been initialized with a source of symbols.
E_INVALIDARGE_INVALIDARG No válido ppSession parámetro.Invalid ppSession parameter.
E_OUTOFMEMORYE_OUTOFMEMORY Memoria insuficiente para abrir la sesión.Insufficient memory to open the session.

ComentariosRemarks

Este método abre un IDiaSession objeto para un origen de datos.This method opens an IDiaSession object for a data source.

IDiaSessionobjetos de implementar las consultas en el origen de datos.IDiaSession objects implement queries into the data source. Una sesión administra un espacio de direcciones para cada conjunto de símbolos de depuración.A session manages one address space for each set of debug symbols. Si el archivo .exe o .dll descrito por los símbolos de origen de datos está activo en varias direcciones intervalos (por ejemplo, porque tienen varios procesos cargado), a continuación, se debe usar una sesión para cada intervalo de direcciones.If the .exe or .dll file described by the data source symbols is active in multiple address ranges (for example, because multiple processes have it loaded), then one session for each address range should be used.

EjemploExample

IDiaSession* pSession;  
HRESULT hr = pSource->openSession( &pSession );  
if (FAILED(hr))  
{  
   // report error  
}  

Vea tambiénSee Also

IDiaDataSource IDiaDataSource
Información general Overview
IDiaSession IDiaSession
Consultar el archivo .pdbQuerying the .Pdb File