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
}

Weitere Informationen