IF_TargetsHandler - SubscribeEventsListener (Methode)

Übersicht

Typ:	Methode
Verfügbar ab:	V1.4.1.0

Dieses Kapitel enthält Informationen zu folgenden Aspekten:

oAufgabenstellung

oBeschreibung

oSchnittstelle

oDiagnosemeldungen

Aufgabenstellung

Abonniert die Implementierung für den Ziel-Handler.

Beschreibung

Die Methode SubscribeEventsListener ermöglicht Ihnen, Ihre Implementierung für den Ziel-Handler zu abonnieren. Dies hat zur Folge, dass jedes Mal, wenn eines der in der Schnittstelle IF_TargetsHandlerEventsListener enthaltenen Ereignisse eintritt, der Ziel-Handler die zugehörige Methode aufruft, indem er einen bestimmten Satz von Informationen übergibt.

Die Verwendung der Methode SubscribeEventsListener ist optional. Sie hat keine Auswirkung auf die Funktionen des Ziel-Handlers.

Weitere Informationen finden Sie in der Bibliotheksschnittstelle IF_TargetsHandlerEventsListener, die eine Liste der Methoden enthält, die mit Ereignissen verknüpft sind, die während des Betriebs des Ziel-Handlers auftreten (z. B. ein neues Ziel wird der Liste hinzugefügt, ein Ziel wird entfernt).

Schnittstelle

Eingang	Datentyp	Beschreibung
i_ifTargetsHandlerEventsListener	IF_TargetsHandlerEventsListener	Eine Schnittstelle, die eine Liste mit Methoden enthält, die sich auf Ereignisse beziehen, die während der regelmäßigen Verwendung eines Ziel-Handler-Funktionsbausteins auftreten.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. EinWert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	Bausteinspezifischer Ausgang zur Diagnose. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung
q_sMsg	STRING[80]	Ereignisabhängige Meldung, die detaillierte Informationen zum Diagnosezustand übergibt.

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. EinWert ungleich GD.ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

Bausteinspezifischer Ausgang zur Diagnose.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

q_sMsg

STRING[80]

Ereignisabhängige Meldung, die detaillierte Informationen zum Diagnosezustand übergibt.

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
Ok	Ok	0	Ok
ExecutionAborted	AlreadyConfigured	100	Der Funktionsbaustein ist bereits konfiguriert.
ExecutionAborted	MaxNumberOfEventsListenersExceeded	107	Die Anzahl der abonnierten Ereignis-Listener ist größer als die maximal zulässige Anzahl.
InputParameterInvalid	InterfaceInvalid	122	Eine angegebene Schnittstelle ist ungültig.

AlreadyConfigured

Enumerationsname:	AlreadyConfigured
Enumerationswert:	100
Beschreibung:	Der Funktionsbaustein ist bereits konfiguriert.

Problem	Ursache	Lösung
Der Ereignis-Listener wurde nicht abonniert.	Es war nicht möglich, einen Ereignis-Listener zu abonnieren, da der Funktionsbaustein bereits konfiguriert wurde.	Stellen Sie sicher, dass die Methode SubscribeEventsListener vor einem erfolgreichen Aufruf der Methode Configuration aufgerufen wird.

InterfaceInvalid

Enumerationsname:	InterfaceInvalid
Enumerationswert:	122
Beschreibung:	Eine angegebene Schnittstelle ist ungültig.

Problem	Ursache	Lösung
Der Ereignis-Listener wurde nicht abonniert.	i_ifTargetsHandlerEventsListener enthält eine Null-Schnittstelle.	Geben Sie eine gültige Implementierung der Schnittstelle IF_TargetsHandlerEventsListener an.

MaxNumberOfEventsListenersExceeded

Enumerationsname:	MaxNumberOfEventsListenersExceeded
Enumerationswert:	107
Beschreibung:	Die Anzahl der abonnierten Ereignis-Listener ist größer als die maximal zulässige Anzahl.

Problem	Ursache	Lösung
Der Ereignis-Listener wurde nicht abonniert.	Der Ziel-Handler enthält bereits die maximal zulässige Anzahl der Ereignis-Listener.	Stellen Sie sicher, dass maximal Gc_uiMaxNumberOfEventsListeners Ereignis-Listener abonniert sind.

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	Ok

Statusmeldung: Der Ereignis-Listener wurde abonniert.