Freigeben über


Melden von Fehlern aus Pipelinekomponenten

Pipelinekomponenten melden Fehler auf zwei Arten:

  • Für .NET-basierte Komponenten durch das Auslösen einer Ausnahme.

  • Für COM-basierte Komponenten legen Sie das ErrorInfo-Objekt fest und geben ein Fehler-HRESULT zurück.

Melden von Fehlern aus .NET-Pipelinekomponenten

Um einen Fehler zu melden, eine . Net-basierte Pipelinekomponente muss eine Ausnahme auslösen, bei der die Fehlerbeschreibung gemeldet wird. Wenn Sie den Namen der Komponente melden möchten, die einen Fehler auslöst, legen Sie die Source-Eigenschaft des Exception-Objekts fest.

Das Messagingmodul verwendet die Nachrichten- und Quelleigenschaften des Exception-Objekts , um einen Fehler zu melden. Die folgende Nachricht wird in das Ereignisprotokoll geschrieben:

"Fehler beim Ausführen der [receive|send]-Pipeline: <Pipelinename> Quelle: <Quelle> [Empfangsspeicherort|Port senden:] <Standort|Portname> Grund: <Nachricht>."

Melden von Fehlern aus COM-Pipelinekomponenten

Um einen Fehler zu melden, führen COM-basierte Pipelinekomponenten die folgenden Aktionen aus:

  1. Die Pipelinekomponente legt das IErrorInfo-Objekt fest, indem die SetErrorInfo-Methode aufgerufen wird.

  2. Die Pipelinekomponente gibt ein negatives HRESULT an die Messaging-Engine zurück.

    Das Messagingmodul verwendet die GetSource - und GetDescription-Eigenschaften des IErrorInfo-Objekts , um einen Fehler zu melden. Wenn die Quelle nicht festgelegt ist, wird der Name der Komponente verwendet. Wenn die Beschreibung nicht festgelegt ist oder das gesamte ErrorInfo-Objekt nicht festgelegt ist, wird das zurückgegebene HRESULT anstelle der Beschreibung gemeldet. Die folgende Nachricht wird in das Ereignisprotokoll geschrieben:

    Fehler beim Ausführen der [receive|send]-Pipeline: <Pipelinename> Quelle: <GetSource> [Empfangsort|Sendeport:] <Speicherort|Portname> Grund: <GetDescription oder HRESULT>.

Siehe auch

Entwickeln von benutzerdefinierten Pipelinekomponenten