Procedure: HRESULTs aan uitzonderingen koppelen

COM-methoden melden fouten door HRESULTs te retourneren; .NET methoden rapporteren ze door uitzonderingen te genereren. De runtime verwerkt de overgang tussen de twee. Elke uitzonderingsklasse in .NET wordt toegewezen aan een HRESULT.

Door gebruikers gedefinieerde uitzonderingsklassen kunnen elke HRESULT specificeren die geschikt is. Deze uitzonderingsklassen kunnen het HRESULT dynamisch wijzigen dat moet worden geretourneerd wanneer de uitzondering wordt gegenereerd door het HResult veld in te stellen op het uitzonderingsobject. Aanvullende informatie over de uitzondering wordt aan de client verstrekt via de IErrorInfo interface, die wordt geïmplementeerd op het .NET-object in het onbeheerde proces.

Als u een klasse maakt die is afgeleid van System.Exception, moet u het HRESULT-veld tijdens de constructie instellen. Anders wijst de basisklasse de HRESULT-waarde toe. U kunt nieuwe uitzonderingsklassen toewijzen aan een bestaand HRESULT door de waarde in de constructor van de uitzondering op te geven.

Houd er rekening mee dat de runtime een HRESULT soms negeert wanneer er een IErrorInfo aanwezig is op de thread. Dit gedrag kan optreden in gevallen waarin de HRESULT en de IErrorInfo fout niet dezelfde fout vertegenwoordigen.

Een nieuwe uitzonderingsklasse maken en toewijzen aan een HRESULT

1. Gebruik de volgende code om een nieuwe uitzonderingsklasse met de naam NoAccessException te maken en deze te koppelen aan de HRESULT E_ACCESSDENIED.

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

U kunt een programma (in elke programmeertaal) tegenkomen dat tegelijkertijd beheerde en onbeheerde code gebruikt. De aangepaste marshaller in het volgende codevoorbeeld gebruikt bijvoorbeeld de Marshal.ThrowExceptionForHR(int HResult) methode om een uitzondering met een specifieke HRESULT-waarde te genereren. De methode zoekt het HRESULT op en genereert het juiste uitzonderingstype. Bijvoorbeeld genereert het HRESULT in het volgende codefragment ArgumentException.

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

De volgende tabel geeft de gebruikelijke overeenkomsten weer van HRESULT naar de overeenkomende uitzonderingsklasse in .NET. HRESULT-waarden zonder expliciete toewijzingen worden toegewezen aan COMException. De volledige, actuele toewijzing vindt u in de dotnet/runtime-repository.

Voor het ophalen van uitgebreide foutinformatie moet de beheerde client de velden van het gegenereerde uitzonderingsobject onderzoeken. Om het uitzonderingsobject nuttige informatie te geven over een fout, moet het COM-object de IErrorInfo interface implementeren. De runtime gebruikt de informatie die door IErrorInfo wordt verschaft om het exception-object te initialiseren.

Als het COM-object geen ondersteuning biedt IErrorInfo, initialiseert de runtime een uitzonderingsobject met standaardwaarden. De volgende tabel bevat elk veld dat is gekoppeld aan een uitzonderingsobject en identificeert de bron van standaardinformatie wanneer het COM-object ondersteuning biedt IErrorInfo.

Houd er rekening mee dat de runtime een HRESULT soms negeert wanneer er een IErrorInfo aanwezig is op de thread. Dit gedrag kan optreden in gevallen waarin de HRESULT en de IErrorInfo fout niet dezelfde fout vertegenwoordigen.

Uitzonderingsvelden, zoals Message, Sourceen StackTrace zijn niet beschikbaar voor de StackOverflowException.

Zie ook

• Geavanceerde COM-interoperabiliteit
• Uitzonderingen