Die Funktion kcHttpGetScheme liefert das Scheme des HTTP-Requests zurück. Das Scheme wird in der Form zurückgegeben, in der es in der URL enthalten ist, z.B. 'https'.
Die Funktion kann im Teilprogramm und im HTTP-Exit-Programm aufgerufen werden.
Im Teilprogramm darf die Funktion nur im ersten Teilprogrammlauf eines Vorgangs aufgerufen werden.
kc_http_retcode kcHttpGetScheme( char * scheme,
int * schemeLth
);
Diese Funktion hat folgende Funktionsparameter:
| << | scheme | Adresse des Puffers, in dem das Scheme des HTTP-Requests zurückgegeben wird. Der Puffer muss mindestens schemeLth Bytes lang sein. |
| <> | schemeLth | Adresse einer Variablen, in der die Länge des Puffers für das Scheme des HTTP-Requests übergeben und die tatsächliche Länge des Scheme 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 vor dem KDCS-Aufruf INIT oder nicht im ersten Teilprogrammlauf eines Vorgangs oder außerhalb eines HTTP-Exit-Programms aufgerufen.
KC_HTTP_NO_HTTP_CLIENT
Der Vorgang wurde nicht von einem HTTP-Client gestartet.
KC_HTTP_PARAM_VALUE_NULL
Die Adresse des Puffers für das Scheme des HTTP-Requests scheme oder die Adresse der Länge des Scheme schemeLth ist NULL.
KC_HTTP_INVALID_LENGTH
Der Wert der Länge des Scheme schemeLth ist kleiner oder gleich 0.
KC_HTTP_RESULT_TRUNCATED
Die Länge des Puffers für das Scheme des HTTP-Requests ist kleiner als die tatsächliche Länge des Scheme. Das Scheme wird verkürzt und die tatsächliche Länge wird zurückgegeben.