IDiaDataSource::openSession
Öffnet eine Sitzung zum Abfragen von Symbolen.
Syntax
HRESULT openSession (
IDiaSession** ppSession
);
Parameter
ppSession
[out] Gibt ein IDiaSession-Objekt zurück, das die geöffnete Sitzung darstellt.
Rückgabewert
Wenn die Ausführung erfolgreich ist, wird S_OK, andernfalls ein Fehlercode zurückgegeben. In der folgenden Tabelle werden die möglichen Rückgabewerte für diese Methode angezeigt.
| Wert | Beschreibung |
|---|---|
| E_UNEXPECTED | Das IDiaDataSource-Objekt wurde zuvor nicht mit einer Quelle von Symbolen initialisiert. |
| E_INVALIDARG | Ungültiger ppSession-Parameter. |
| E_OUTOFMEMORY | Nicht genügend Arbeitsspeicher, um die Sitzung zu öffnen. |
Bemerkungen
Diese Methode öffnet ein IDiaSession-Objekt für eine Datenquelle.
IDiaSession-Objekte implementieren Abfragen in der Datenquelle. Eine Sitzung verwaltet einen Adressraum für jeden Satz von Debugsymbolen. Wenn die durch die Datenquellensymbole beschriebene EXE- oder DLL-Datei in mehreren Adressbereichen aktiv ist (z. B. weil sie von mehreren Prozessen geladen wurde), sollte für jeden Adressbereich eine Sitzung verwendet werden.
Beispiel
IDiaSession* pSession;
HRESULT hr = pSource->openSession( &pSession );
if (FAILED(hr))
{
// report error
}