IF_TargetsHandler - RemoveTarget (Methode)

Übersicht

Typ:	Methode
Verfügbar ab:	V1.4.1.0

Dieses Kapitel enthält Informationen zu folgenden Aspekten:

Aufgabenstellung

Entfernt ein Ziel aus der Liste.

Beschreibung

Die Methode RemoveTarget ermöglicht es Ihnen, ein Ziel aus der Liste zu entfernen.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_udiListIndex	UDINT	Der Index des aus der Liste zu entfernenden Ziels.

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

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

q_etDiagExt

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	NotConfigured	101	Der Funktionsbaustein wurde noch nicht konfiguriert.
ExecutionAborted	UpdateTargetsActive	109	Eine Aktualisierung des Ziels des Ziel-Handlers wird ausgeführt, und einige Methoden können nicht aufgerufen werden.
InputParameterInvalid	ListIndexInvalid	112	Der angegebene Listenindex bezieht sich nicht auf ein gültiges Ziel in der Liste.
InputParameterInvalid	ListIndexRange	111	Der angegebene Index ist entweder Null oder größer als die maximale Listengröße.

ListIndexInvalid

Enumerationsname:	ListIndexInvalid
Enumerationswert:	112
Beschreibung:	Der angegebene Listenindex bezieht sich nicht auf ein gültiges Ziel in der Liste.

Problem	Ursache	Lösung
Das Ziel wurde nicht aus dem Ziel-Handler entfernt.	Der Ziel-Handler enthält kein Ziel mit dem angegebenen Index.	Stellen Sie sicher, dass ein Ziel mit dem Index i_udiListIndex in der Liste enthalten ist.

ListIndexRange

Enumerationsname:	ListIndexRange
Enumerationswert:	111
Beschreibung:	Der angegebene Index ist entweder Null oder größer als die maximale Listengröße.

Problem	Ursache	Lösung
Das Ziel wurde nicht aus dem Ziel-Handler entfernt.	Der Wert des Index liegt außerhalb des gültigen Bereichs.	Der Wert des Index muss innerhalb des Bereichs [1 bis Gc_udiMaxNumberOfTargets] liegen.

NotConfigured

Enumerationsname:	NotConfigured
Enumerationswert:	101
Beschreibung:	Der Funktionsbaustein wurde noch nicht konfiguriert.

Problem	Ursache	Lösung
Das Ziel wurde nicht aus dem Ziel-Handler entfernt.	Die Methode Configuration wurde noch nicht aufgerufen.	Stellen Sie sicher, dass die Methode Configuration erfolgreich aufgerufen wurde, bevor diese Methode aufgerufen wird.

Statusmeldung: Das Ziel wurde erfolgreich aus dem Ziel-Handler entfernt.

UpdateTargetsActive

Enumerationsname:	UpdateTargetsActive
Enumerationswert:	109
Beschreibung:	Eine Aktualisierung der Ziele des Ziel-Handlers wird ausgeführt, und einige Methoden können nicht aufgerufen werden.

Problem	Ursache	Lösung
Das Ziel wurde nicht aus dem Ziel-Handler entfernt.	Es ist nicht möglich, ein Ziel aus dem Ziel-Handler zu entfernen, während die Methode UpdateTargets ausgeführt wird.	Stellen Sie sicher, dass die Methode UpdateTargets nicht ausgeführt wird, bevor Sie diese Methode aufrufen.