Mit der Funktion kcHttpPutMgetMsg kann eine Nachricht für das Teilprogramm von einem HTTP-Exit-Programm erzeugt werden, die mit MGET gelesen werden kann.
Die Nachricht kann sukzessive mit mehreren Aufrufen der Funktion aufgebaut werden, ohne dass sich der Aufrufer selbst um die Anforderung und Verwaltung des benötigten Speicherbereichs kümmern muss. Wie Sie diese Nachricht in Nachrichtenteile strukturieren, die im Teilprogramm mit MGET NT gelesen werden können, ist in Kapitel „Event-Exit HTTP" beschrieben.
Diese Funktion darf nur von einem HTTP-Exit-Programm beim Bearbeiten der Eingabenachricht aufgerufen werden.
kc_http_retcode kcHttpPutMgetMsg( void * mgetMessage,
int mgetMessageLth,
void ** totalMgetMessage,
int * totalMgetMessageLth
);
Diese Funktion hat folgende Parameter:
| >> | mgetMessage | Adresse der übergebenen Nachricht bzw. des übergebenen Nachrichtenteils. |
| >> | mgetMessageLth | Länge der übergebenen Nachricht bzw. des übergebenen Nachrichtenteils. |
| << | totalMgetMessage | Adresse einer Variablen, in der die Adresse der bisher aufgebauten Gesamtnachricht zurückgegeben wird. |
| << | totalMgetMessageLth | Adresse einer Variablen, in der die Länge der bisher aufgebauten Gesamtnachricht zurückgegeben wird. |
Der zurückgelieferte Funktionswert hat folgende Bedeutung:
KC_HTTP_OK
Die Funktion wurde erfolgreich ausgeführt.
KC_HTTP_FUNCTION_CALL_NOT_ALLOWED
Die Funktion wurde nicht von einem HTTP-Exit Programm beim Bearbeiten der Eingabenachricht aufgerufen.
KC_HTTP_PARAM_VALUE_NULL
Die Adresse der Nachricht mgetMessage, die Adresse der Variablen totalMgetMessage oder die Adresse der Variablen totalMgetMessageLth ist NULL.
KC_HTTP_INVALID_LENGTH
Der Wert des Parameters mgetMessageLth ist kleiner oder gleich 0.
KC_HTTP_MEMORY_INSUFFICIENT
Es konnte kein weiterer Speicher für die Gesamtnachricht allokiert werden.