Behandeln von COM+-Verwaltungsfehlern
Fehler, die beim Verwenden der COMAdmin-Objekte generiert werden, werden wie folgt gemeldet:
- Verwenden von Fehlercodes, die für die COMAdmin-Bibliothek spezifisch sind.
- Verwenden erweiterter Fehlerinformationen, die in einer speziellen ErrorInfo-Sammlung verfügbar sind.
Fehlercodes
Sie behandeln Verwaltungsfehlercodes wie jede COM-Fehlermeldung. In Microsoft Visual C++ werden diese Codes als HRESULT-Werte zurückgegeben. In Microsoft Visual Basic werden sie als Ausnahmen ausgelöst, die Sie abfangen können. Für C++-Programmierer sind die COM+-Verwaltungsfehlercodes in Winerror.h definiert. Für Visual Basic-Programmierer sind sie über die Visual Basic-IDE verfügbar.
ErrorInfo-Sammlung
Wenn ein Fehler auftritt, der durch eine Art von Fehlercode signalisiert wird, sind je nach Art des Fehlers möglicherweise ausführlichere Informationen verfügbar. Die COMAdmin-Objekte bieten erweiterte Informationen in Fällen, in denen die genaue Ursache des Fehlers ohne einen detaillierten Bericht nur schwer zu ermitteln ist, z. B. bei mehreren Lese- und Schreibvorgängen.
Wenn Sie beispielsweise Methoden wie Populate und SaveChanges für ein COMAdminCatalogCollection-Objekt verwenden, können Sie Daten für jedes Element in der Auflistung lesen oder schreiben. Komplizierte Fehler können auftreten, die anhand eines einzelnen numerischen Fehlercodes schwer zu diagnostizieren sind. Daher erstellt die COMAdmin-Bibliothek erweiterte Fehlerinformationen über eine spezielle Auflistung.
Wenn erweiterte Fehlerinformationen verfügbar sind, werden sie in der ErrorInfo-Auflistung platziert, die sich auf die ursprüngliche Auflistung bezieht, bei der der Fehler aufgetreten ist. Um den Fehlerbericht abzurufen, rufen Sie die ErrorInfo-Auflistung ab, die sich auf die ursprüngliche Auflistung bezieht, und untersuchen Sie die enthaltenen Elemente. Sie können die ErrorInfo-Auflistung mithilfe von GetCollection in COMAdminCatalogCollection abrufen, wobei der zweite Parameter leer bleibt, wobei Sie normalerweise die Key-Eigenschaft eines übergeordneten Elements angeben würden.
Wenn Sie einen Fehler erhalten, müssen Sie sofort die ErrorInfo-Auflistung für die Auflistung abrufen und auffüllen, die fehlgeschlagen ist, ohne andere Vorgänge für diese Auflistung auszuführen. Andernfalls wird die ErrorInfo-Auflistung zurückgesetzt und enthält keine Details zu diesem Fehler.
Die Elemente in der ErrorInfo-Auflistung machen die speziellen Fehlerberichtseigenschaften MajorRef und MinorRef verfügbar, die die jeweilige Ursache des Fehlers beschreiben. Weitere Informationen finden Sie unter ErrorInfo.
Zugehörige Themen