UserData
Die Eigenschaft gibt die benutzerdefinierten Daten des Events zurück. Die Benutzerdaten wurden zugeordnet, als das Event vom SPS Funktionsblock (oder eines anderen ADS Geräts) oder durch den Aufruf der Report EventFunction wie ITcEventLogC::ReportEvent, ITcEventC3::ReportEventEx oder ITcEventLog::ReportEvent mit den TcEventFlags ausgegeben wurde.
HRESULT UserData([out, retval] long *pVal);
Parameter
pVal
[out, retval] Pointer auf einen long Wert, der die Benutzerdaten enthält.
Rückgabe Werte
S_OK
Funktion wurde erfolgreich aufgerufen.
E_POINTER
pVal war kein gültiger Pointer.
Visual Basic Beispiel-Code
' get the one and only event logger
Dim evtLogger As TCEVENTLOGGERLib.TcEventLog
Set evtLogger = New TCEVENTLOGGERLib.TcEventLog
' get the most recent active event
Dim evt As TcEvent
Set evt = evtLogger.GetLastEvent
' get the MustConfirm flag
Dim mustConf As Long
mustConf = evt.mustConfirm
If mustConf <> 0 Then
Debug.Print "Must Confirmed!"
Else
Debug.Print "Must Not Confirmed!"
End If
Anmerkungen
Der Rückgabewert ist nicht vom Typ VARIANT_BOOL sondern vom Visual Basic Typ BOOLEAN. In Visual Basic kommt er als Long-Wert vor. Wir müssen prüfen, ob er ungleich 0 ist, wenn das Flag gesetzt ist.