HRESULTs und Ausnahmen

COM-Methoden melden Fehler durch die Rückgabe von HRESULTs, .NET-Methoden dagegen durch das Auslösen von Ausnahmen. Common Language Runtime verwaltet den Übergang zwischen beiden. Jede Ausnahmeklasse in .NET Framework wird einem HRESULT zugeordnet.

Durch benutzerdefinierte Ausnahmeklassen kann festgelegt werden, welches HRESULT angemessen ist. Durch diese Ausnahmeklassen kann das HRESULT dynamisch geändert werden, das beim Generieren einer Ausnahme zurückgegeben werden soll, indem das HResult-Feld auf das Ausnahmeobjekt eingestellt wird. Zusätzliche Informationen über die Ausnahme werden dem Client über die Schnittstelle IErrorInfo bereitgestellt, die auf dem .NET-Objekt im nicht verwalteten Prozess implementiert ist.

Wenn Sie eine Klasse erstellen, die System.Exception erweitert, müssen Sie das HRESULT-Feld während der Konstruktion festlegen. Ansonsten weist die Basisklasse den HRESULT-Wert zu. Sie können neue Ausnahmeklassen einem vorhandenen HRESULT zuordnen, indem Sie den Wert im Konstruktor der Ausnahme angeben. Im folgenden Beispiel wird eine neue Ausnahmeklasse erstellt, die NoAccessException genannt wird. Diese wird dann dem HRESULT E_ACCESSDENIED zugeordnet:

Class NoAccessException : public ApplicationException
{
    NoAccessException {} {
    HResult = E_ACCESSDENIED; 
}
}
CMyClass::MethodThatThrows
{
throw new NoAccessException();
}

Es kann vorkommen, dass ein Programm (in einer beliebigen Programmiersprache) gleichzeitig verwalteten und nicht verwalteten Code verwendet. So verwendet z. B. der benutzerdefinierte Marshaller im folgenden Codebeispiel die Marshal.ThrowExceptionForHR(int HResult)-Methode, um eine Ausnahme mit einem spezifischen HRESULT-Wert auszulösen. Die Methode sucht nach dem HRESULT und generiert den entsprechenden Ausnahmetyp. Im folgenden Codefragment wird z. B. ArgumentException generiert.

CMyClass::MethodThatThrows
{
    Marshal.ThrowExceptionForHR(COR_E_ARGUMENT);
}

In der folgenden Tabelle wird eine vollständige Zuordnung eines jeden HRESULT zur vergleichbaren Ausnahmeklasse in .NET Framework angegeben.

Um erweiterte Fehlerinformationen abzurufen, muss der verwaltete Client die Felder des generierten Ausnahmeobjekts untersuchen. Damit das Ausnahmeobjekt nützliche Fehlerinformationen bereitstellen kann, muss die Schnittstelle IErrorInfo durch das COM-Objekt implementiert werden. Die von IErrorInfo bereitgestellte Information wird von der Laufzeit zur Initialisierung des Ausnahmeobjekts verwendet.

Wenn das COM-Objekt IErrorInfo nicht unterstützt, wird durch Common Language Runtime ein Ausnahmeobjekt mit Standardwerten initialisiert. In der folgenden Tabelle wird jedes Feld aufgeführt, das einem Ausnahmeobjekt zugeordnet ist, und die Standardinformationsquelle angegeben, wenn das COM-Objekt IErrorInfo unterstützt.

Ausnahmefelder wie Message, Source und StackTrace sind für StackOverflowException nicht verfügbar.

Siehe auch

Erweitertes COM-Interop | Behandeln und Auslösen von Ausnahmen