Toolmaker Produkt-Dokumentation

MidJet Windows Monitor DLL

Diese DLL welche unter Verwendung des Borland C+++ Builders entwickelt wurde, beinhaltet zwei APIs: SndMsg und SndErr. Zusammen mit der DLL-Datei existiert noch eine LIB-Datei, MidJet.lib genannt.

SndMsg API

Dieses API sendet eine Nachricht an einen TCP/IP-Server. Die Nachricht ist aufgebaut aus Telefonnummer, einem Nachrichtentext und einem Alarmcode.
Die IP-Adresse und Port-Nummer des Servers muss im KonfigTool der MidJet Windows-Monitor Software angegeben werden.

Syntax

extern "C" int_export SndMsg (char * phone, char * text, char alert);

Falls Ihr Programm ein C-Programm ist, können Sie die externe „C"-Bestimmung löschen.

Parameter

Phone ist eine Zeichenfolge der Telefonnummer mit max. 20 Stellen Länge.

Text ist eine Zeichenfolge mit dem Nachrichtentext von max. 160 Stellen Länge.

Alert ist ein Zeichenfeld.

Rückkehrwert

0 =SndMsg erfolgreich
-1 =SndMsg aufgrund eines Kommunikationsfehlers fehlgeschlagen. Eine Erklärung kann durch das SndErr-API erhalten werden.
>0 Der Server gibt diesen Code zurück. Die Bedeutung des Codes liegt hinter diesem API. Schlagen Sie in der Server-Dokumentation nach.

SndErr API

Diese API gibt einen Nachrichtentext zurück der den Grund des Kommunikationsfehlers beinhaltet der während der Ausführung des SndMsg-APIs aufgetreten ist.

Syntax

extern "C" char * _export SndErr ();

Falls Ihr Programm ein C-Programm ist, können Sie die externe „C"-Bestimmung löschen.

Parameter

Keine

Rückkehrwerte

Ein Pointer zu einer Fehlerzeichenfolge.