AddConnection

ITcEventView

Diese Methode fügt eine neue Verbindung zu einem PC im Netzwerk hinzu.

Standardmäßig wird die Remoteverbindung via *DCOM hergestellt, durch das Präfix ADS:// wird die Kommunikationsstrecke per **ADS überbrückt.

HRESULT AddConnection(BSTR strComputerName);

Parameter

strComputerName

[in] BSTR Name des remote PC mit dem der TcEventViewer eine Verbindung herstellen soll.

Rückgabe Werte

S_OK

Funktion wurde erfolgreich aufgerufen.

TCEVTVIEWERR_ADVISESINK = 0xF1000000

Eine Verbindung mit dem remote EventLogger konnte hergestellt werden aber das Anmelden der EventSink ist fehlgeschlagen. In diesem Fall müssen Meldungen durch Aufrufe der ShowEvents Methode gepollt werden. Das high order Byte beschreibt den Fehlerfall, die low order Bytes stellen den ursprünglichen Win32 Fehler Code dar, der vom DispEventAdvise Aufruf zurückgegeben wurde.

TCEVENTERR_ADS = 0x98200000

Bei Verwendung der ADS Schnittstelle werden ADS Fehler gegebenenfalls durchgereicht. Das Lowword enthält dann den Zugrundeliegenden Ads Fehlercode.

 

Visual Basic Beispielcode

Option Explicit

' add the Beckhoff TcEvent View Library to the components
' place a TcEventView on the form, and assign the name
TcEventView1

Private Sub Form_Load()
 Call TcEventView1.AddConnection("BeltPC1")
End Sub

Anmerkungen

*DCOM: DCOM sollte nur in stabilen Netzwerken verwendet werden. DCOM muss korrekt auf dem PC eingerichtet sein, der TcEvenView verwendet, und auf dem PC, der den TcEventLogger durch die Verwendung von dcomcnfg.exe bereitstellt. Weitere Informationen finden Sie in der MSDN Library.

**ADS: Um ADS zur Verbindung mit einem Remotesystem zu nutzen, muss die Verbindung zunächst eingerichtet werden. Beide Systeme müssen gewisse Mindestanforderungen erfüllen. Weitere Informationen hierzu finden sie hier