Die C-Unterprogramm-Schnittstelle des Mail-Sender-Frontends unterstützt die folgenden Funktionsaufrufe:
Funktionsaufruf | Funktion | Zugehörige Include-Datei mit |
YMLSML() | Mail senden | YMLSML.H |
YMLCML() | Mail-Resultat abholen | YMLCML.H |
YMLDML() | Mail löschen | YMLDML.H |
YMLGML() | Information zur Mail abfragen | YMLGML.H |
C-Funktionsaufrufe und verwendete Include-Dateien
Die bei der Assembler-Makro-Schnittstelle (ab "Assembler-Makro-Schnittstelle") beschriebene Erweiterung der Unterprogrammschnittstelle um den Parameter VERSION sowie weitere Parameter und Return-Codes wirkt sich ebenfalls auf die C-Include-Dateien aus. Die Auswahl zwischen der alten und der neuen Schnittstellen-Version findet durch die Definition eines Präprozessor-Symbols vor dem Inkludieren der jeweiligen Include-Datei statt.
Wenn Sie die VERSION=1-Variante der Include-Dateien verwenden, geben Sie Folgendes an:
#define _YMLCML_H_VERSION_1 #include "YMLCML.H" #define _YMLDML_H_VERSION_1 #include "YMLDML.H" #define _YMLGML_H_VERSION_1 #include "YMLGML.H" #define _YMLSML_H_VERSION_1 #include "YMLSML.H"
Wenn Sie die VERSION=2-Variante der Include-Dateien verwenden, geben Sie Folgendes an:
#define _YMLCML_H_VERSION_2 #include "YMLCML.H" #define _YMLDML_H_VERSION_2 #include "YMLDML.H" #define _YMLGML_H_VERSION_2 #include "YMLGML.H" #define _YMLSML_H_VERSION_2 #include "YMLSML.H"
Für die Versorgung der Function-Header mit Unit-, Function- und Version-Werten werden in den Include-Dateien entsprechende Präprozessorsymbole definiert, so z.B. für YMLSML die Symbole YMLSML_UNIT, YMLSML_FUNCTION und YMLSML_VERSION. Letzteres ist abhängig von der ausgewählten Schnittstellen-Version.
Die im Folgenden aufgelisteten C-Include-Dateien deklarieren die Funktionen sowie die Datenstrukturen, die von ihnen verwendet werden.