IDiaDataSource::openSessionIDiaDataSource::openSession

Ouvre une session pour l’interrogation des symboles.Opens a session for querying symbols.

SyntaxeSyntax

HRESULT openSession (   
   IDiaSession** ppSession  
);  

ParamètresParameters

ppSessionppSession
[out] Retourne un IDiaSession objet représentant la session ouverte.[out] Returns an IDiaSession object representing the open session.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK; sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code. Le tableau suivant montre les valeurs de retournés possibles pour cette méthode.The following table shows the possible return values for this method.

ValueValue DescriptionDescription
E_UNEXPECTEDE_UNEXPECTED Le IDiaDataSource objet n’a pas déjà été initialisé avec une source de symboles.The IDiaDataSource object has not previously been initialized with a source of symbols.
E_INVALIDARGE_INVALIDARG Non valide ppSession paramètre.Invalid ppSession parameter.
E_OUTOFMEMORYE_OUTOFMEMORY Mémoire insuffisante pour ouvrir la session.Insufficient memory to open the session.

NotesRemarks

Cette méthode ouvre un IDiaSession objet pour une source de données.This method opens an IDiaSession object for a data source.

IDiaSession objets d’implémenter des requêtes dans la source de données.IDiaSession objects implement queries into the data source. Une session gère un espace d’adressage pour chaque ensemble de symboles de débogage.A session manages one address space for each set of debug symbols. Si le fichier .exe ou .dll décrit par les symboles de source de données est active dans la zone Adresse plusieurs plages (par exemple, étant donné que plusieurs processus ont chargé), puis une session pour chaque plage d’adresses doit être utilisée.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.

ExempleExample

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

Voir aussiSee Also

IDiaDataSource IDiaDataSource
Vue d’ensemble Overview
IDiaSession IDiaSession
Interrogation du fichier .PdbQuerying the .Pdb File