Vorgehensweise: Zuordnen von HRESULTs und Ausnahmen

COM-Methoden melden Fehler durch Zurückgeben von HRESULTs; .NET Methoden melden sie durch Auslösen von Ausnahmen. Die Laufzeit steuert den Übergang zwischen beiden. Jede Ausnahmeklasse in .NET ist einem HRESULT zugeordnet.

Benutzerdefinierte Ausnahmeklassen können angeben, welche HRESULT geeignet ist. Diese Ausnahmeklassen können das HRESULT dynamisch ändern, das zurückgegeben wird, wenn die Ausnahme generiert wird, indem das HResult Feld für das Ausnahmeobjekt festgelegt wird. Zusätzliche Informationen zur Ausnahme werden dem Client über die IErrorInfo Schnittstelle bereitgestellt, die für das .NET-Objekt im nicht verwalteten Prozess implementiert wird.

Wenn Sie eine Klasse erstellen, die erweitert wird System.Exception, müssen Sie das HRESULT-Feld während der Konstruktion festlegen. Andernfalls weist die Basisklasse den HRESULT-Wert zu. Sie können einem vorhandenen HRESULT neue Ausnahmeklassen zuordnen, indem Sie den Wert im Konstruktor der Ausnahme angeben.

Beachten Sie, dass die Laufzeit HRESULT in Fällen manchmal ignoriert, in denen IErrorInfo im Thread vorhanden ist. Dieses Verhalten kann in Fällen auftreten, in denen die HRESULT und die IErrorInfo nicht denselben Fehler darstellen.

So erstellen Sie eine neue Ausnahmeklasse und ordnen sie einem HRESULT zu

1. Verwenden Sie den folgenden Code, um eine neue Ausnahmeklasse mit dem Namen NoAccessException zu erstellen und sie dem HRESULT E_ACCESSDENIED zuzuordnen.

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

Möglicherweise treffen Sie auf ein Programm (in jeder Programmiersprache), das verwalteten und nicht verwalteten Code gleichzeitig verwendet. Beispielsweise verwendet der benutzerdefinierte Marshaller im folgenden Codebeispiel die Marshal.ThrowExceptionForHR(int HResult) Methode, um eine Ausnahme mit einem bestimmten HRESULT-Wert auszuwerfen. Die Methode sucht nach dem HRESULT und generiert den entsprechenden Ausnahmetyp. Zum Beispiel generiert das HRESULT im folgenden Codefragment ArgumentException.

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

Die folgende Tabelle enthält die allgemeinen Zuordnungen von HRESULT zur vergleichbaren Ausnahmeklasse in .NET. HRESULT-Werte ohne explizite Zuordnungen werden zugeordnet COMException. Die vollständige, aktuelle Zuordnung finden Sie im dotnet/runtime-Repository.

Um erweiterte Fehlerinformationen abzurufen, muss der verwaltete Client die Felder des generierten Ausnahmeobjekts untersuchen. Damit das Ausnahmeobjekt nützliche Informationen zu einem Fehler bereitstellt, muss das COM-Objekt die IErrorInfo Schnittstelle implementieren. Die Laufzeit verwendet die von IErrorInfo bereitgestellten Informationen, um das Ausnahmeobjekt zu initialisieren.

Wenn das COM-Objekt IErrorInfo nicht unterstützt, initialisiert die Laufzeit ein Ausnahmeobjekt mit Standardwerten. In der folgenden Tabelle werden alle Felder eines Ausnahmeobjekts aufgeführt, und es wird die Herkunft der Standardinformationen angegeben, wenn das COM-Objekt IErrorInfo unterstützt.

Beachten Sie, dass die Laufzeitumgebung ein HRESULT manchmal ignoriert, wenn im Thread ein IErrorInfo vorhanden ist. Dieses Verhalten kann in Fällen auftreten, in denen die HRESULT und die IErrorInfo nicht denselben Fehler darstellen.

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

Siehe auch

• Erweiterte COM-Interoperabilität
• Ausnahmen